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关于 自动 化 测试 的 工具 和 框架 其 实 有 很 多 。 自 动 化 测试 在 测试 I 行业 中 扮演 着 越 来 越 重 
要 的 角色 ， 不 管 是 在 传统 的 IT 行业 还 是 高 速 发 展 的 互联 网 行业 或 是 如 今 的 大 数据 和 大 热 的 人 
工 智能 领域 ， 都 离 不 开 测 试 ， 也 更 加 离 不 开 自动 化 测试 。 自 动 化 测试 已 经 发 展 了 很 多 年 ， 在 很 
多 大 的 互联 网 公司 里 他 们 不 但 有 自己 的 自动 化 测试 框架 ,甚至 基本 都 建立 了 自己 的 自动 化 测试 
平台 或 者 已 经 对 外 开放 使 用 的 自动 化 测试 云 平台 , 也 就 是 说 自动 化 测试 几乎 已 经 成 为 一 名 测试 
工程 师 必 须 掌 握 的 一 个 技能 , 并 且 随 着 很 多 自动 化 测试 工具 和 框架 的 不 断 发 展 和 完善 ,自动 化 
测试 也 变 得 越 来 越 简单 。Robot Framework 是 目前 众多 自动 化 测试 工具 或 自动 化 测试 框架 中 一 
个 非常 流行 的 开源 框架 , 致力 于 解决 重复 功能 测试 劳动 所 带 来 的 高 额 成 本 , 将 自动 化 测试 大 众 
化 、 简 单 化 、 通 俗 化 ,让 更 多 没有 编程 基础 的 人 也 能 成 功 地 完成 自动 化 测试 ， 降 低 自动 化 测试 
带 来 的 学 习 成 本 。 


2016 年 年 初 ， 作 者 在 规划 写 这 本 书 的 时 候 ， 其 实 已 经 在 开始 谋划 做 职位 转型 ， 从 一 名 软 
件 测试 工程 师 转型 为 一 名 软件 开发 工程 师 , 在 此 之 前 作者 曾经 在 测试 职位 上 打拼 了 8 年 多 , 经 
历 了 手工 功能 测试 、 自 动 化 测试 、 性 能 测试 。 在 写 这 篇 序 时 ， 作 者 已 经 在 转型 后 的 软件 开发 工 
程 师 的 岗位 上 工作 了 1 年 多 , 之 所 以 说 作者 自身 的 经 历 , 其 实 主要 是 想 告诉 每 一 位 想 从 事 自动 
化 测试 的 读者 ， 只 要 想 去 做 或 者 想 去 转型 ， 时 间 和 年 纪 都 不 会 是 太 大 问题 ， 哪 怕 你 已 经 30 岁 
或 者 30 多 岁 了 ， 都 可 以 重新 开启 一 个 新 的 奋斗 起 点 。 作 者 写 这 本 关于 自动 化 测试 框架 的 书 ， 
除了 分 享 一 些 自身 浅薄 的 经 验 外 ,还 有 一 个 目的 就 是 想 鼓励 更 多 还 在 从 事 手工 功能 测试 的 读者 
去 学 习 自 动 化 测试 ， 去 从 事 自动 化 测试 。 


这 本 书 并 不 是 完全 面向 初学 者 来 进行 设计 的 ， 更 多 的 是 比较 适合 有 一 定 自动 化 基础 的 朋 
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友 。 在 本 书 的 后 半 部 分 ， 更 多 的 谈 到 如 何 去 设计 一 个 自动 化 测试 框架 ， 对 于 一 个 刚刚 接触 自 
动 化 测试 的 朋友 来 说 , 刚 开始 可 能 会 稍 显 吃 力 , 但 是 随 着 您 对 自动 化 测试 的 逐步 深入 ,相信 您 
会 越 来 越 轻松 、 越 来 越 喜欢 。 


IW im. Monica 等 众多 执 友 在 我 最 困难 的 时 候 给 予 我 很 多 的 帮助 ， 正 是 有 了 大 家 的 
帮助 才 有 了 这 本 关于 自动 化 测试 框架 的 书 ,由 于 作者 水 平 有 限 , 书 中 难免 会 存在 一 些 不 足 之 处 ， 
恳请 读者 提出 宝贵 的 意见 和 建议 。 


作者 于 南京 
2019 年 1 月 
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Robot Framework 是 一 款 基于 Python 编程 语言 设计 的 、 可 扩展 的 、 关 键 字 驱 动 模式 的 测试 
自动 化 框架 ， 具 备 良 好 的 可 扩展 性 ， 可 以 通过 XML-RPC 服务 扩展 支持 其 他 的 常用 编程 语言 ， 
可 以 同时 测试 多 种 类 型 的 客户 端 或 者 接口 ， 可 以 支持 进行 分 布 式 测试 执行 。 

Robot Framework 具体 的 特点 如 下 : 


易于 使 用 ， 采 用 表格 式 输入 语法 以 及 统一 的 测试 用 例 (Test Case， 也 叫 测 试 案例 ) 格 
X. 

重用 性 好 ， 可 以 利用 现 有 关键 字 来 组 合 新 的 用 户 自 定义 关键 字 。 

支持 资源 文件 ， 支 持 多 种 变量 类 型 ， 包 括 字 符 串 变量 、List 列表 变量 、Dictionary 字 
典 变量 等 。 

测试 用 例 执 行 结果 报告 和 日 志 采 用 HTML 格式 ， 易 于 阅读 和 邮件 转发 。 

提供 标签 以 分 类 来 选择 将 被 执行 的 测试 用 例 ， 使 得 测试 用 例 的 选择 更 加 灵活 。 

支持 Web 界面 测试 、Web 接口 服务 测试 、GUI 测试 、 多 种 终端 测试 。 

支持 多 种 数据 库 的 操作 ， 包 括 常用 的 关系 型 数据 库 、 非 关系 型 数据 库 。 

易于 扩展 自 定义 的 Lib 库 ， 可 以 通过 Python 或 者 Java 等 其 他 开发 语言 来 动态 扩展 Lib Æ. 


Robot Framework 自动 化 测试 框架 的 组 成 如 图 1-0-1 所 示 。 


RobotFrameWork 
RIDE( 自 动 化 案例 客户 端 ) Test Libraries Test Report 
— Am 

Python Java Remot 

[FestTooks| Library Library Library 
第 三 方 测 Java Ce! | 

试 工具 library || Library 

图 1-0-1 


© 集成 了 很 多 流行 的 自动 化 测试 工具 ， 比 如 Appium. Selenium 等 。 
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通过 Jython 的 方式 ， 使 得 以 Python 为 主 的 Robot Framework 自动 化 测试 框架 无 颖 地 
与 Java 语 言 进行 完美 集成 ,也 可 以 通过 XML-RPC 远程 调用 协议 来 支持 Java 或 者 C++ 


等 流行 的 编程 语言 ， 使 对 Python 语言 不 熟悉 的 编程 爱好 者 也 可 以 编写 自 
Library 库 。 


定义 的 


在 Robot Framework 中 ,使 用 Python 语言 实现 了 自动 化 测试 用 例 编 写 的 客户 端 RIDE， 
使 用 RIDE 可 以 非常 简单 地 完成 自动 化 测试 用 例 的 编写 ， 也 可 以 使 用 RIDE 完成 用 户 
层面 的 关键 字 API 的 封装 ， 使 得 不 懂 任 何 编程 语言 的 自动 化 测试 爱好 者 也 可 以 封装 


自己 的 API 关键 字 。 


Robot Framework 除了 提供 了 我 们 上 面 提 到 的 Ride 外 , 还 提供 了 很 多 常用 的 插件 工具 ,如 
表 1-0-1 所 示 。 
表 1-0-1 Robot Framework 常用 的 插件 工具 

工具 插件 说 明 

Eclipse plugin | Robot Framework 为 Eclipse IDE 开发 工具 提供 的 插件 使 得 用 户 也 可 以 在 Eclipse 上 编写 
自动 化 测试 用 例 ，GitHub 地 址 为 : https://github.com/NitorCreations/RobotFramework- 
EclipseIDE/wiki 

Robot Plugin for 和 Eclipse plugin 类 似 ， 是 为 另 一 个 常用 的 IDE 开发 工具 Intellij IDEA 提供 的 插件 ， 使 

IntelliJ IDEA 得 用 户 也 可 以 在 IntelliJ IDEA 上 编写 自动 化 测试 用 例 ，GitHub 地 址 为 : https://plugins. 
jetbrains.com/plugin/7430-robot-plugi: 

Jenkins plugin | 这 是 一 个 Jenkins 上 使 用 的 插件 , 这 个 插件 可 以 使 得 Robot Framework 完美 地 集成 在 当今 
非常 流行 的 持续 集成 工具 Jenkins 上 ,插件 的 访问 网 址 为 : https://wikijenkins-ci.org/display/ 
JENKINS/Robot+Framework+Plugin 

Maven plugin 这 是 Robot Framework 提供 的 maven 仓库 插件 可 以 通过 访问 网 址 “http://robotframework. 
org/MavenPlugin/” 获 取 ， 当 前 最 新 的 版 本 为 1.4.7 

Ant task 这 是 为 另 一 个 打包 工具 ant 提供 的 执行 插件 ,使 得 Robot Framework 可 以 通过 ant 的 方式 
来 运行 。 可 以 通过 访问 网 址 “http://code.google.com/p/robotframework-ant”/ 获 取 该 插件 

Pabot Robot Framework 提供 的 并 发 执行 器 ， 也 就 是 我 们 通常 说 的 多 线程 并 发 执行 模式 ， 可 以 
通过 在 Windows 的 cmd 下 执行 pip install -U robotframework-pabot 命令 进行 在 线 安装 ， 
也 可 以 通过 访问 GitHub 网 址 “https://github.com/mkorpela/pabot” 进 行 下 载 ， 然 后 离线 进 
行 安装 

Atom plugin Robot Framework 为 支持 Atom 而 开发 的 插件 ， 可 以 通过 访问 网 址 “https://atom.io/packages/ 
language-robot-framework” 进 行 下 载 


如 何 创建 一 个 自动 化 测试 项 目 


一 个 Robot Framework 项 目 其 实 就 和 一 个 我 们 平时 熟知 的 单元 测试 项 目 结构 基本 是 一 样 
的 , 也 包含 了 测试 套件 和 测试 用 例 的 概念 。 我 们 可 以 对 Robot Framework 项 目 结构 做 如 图 1-1-1 


所 示 的 划 


分 。 
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Test Casel 


测试 套件 (suite) =. Test Case2 
B 测试 日 录 Directory) = " 
Resource 
KeyWord 
1-1-1 


1.4.1. 创建 测试 项 目 


fE Robot Framework 中 ，Ride 是 一 款 用 Python 语言 实现 的 用 来 做 自动 化 测试 用 例 编写 的 客 
户 端 工具 。 通 过 访问 网 址 “https://pypi.org/project/robotframework-ride/” 即 可 下 载 Ride 工具 包 进 
行 离线 安装 ， 也 可 以 通过 在 Windows 的 cmd 命令 行 中 输入 “pip install robotframework-ride” 进 
行 在 线 自 动 安装 。 安 装 完成 后 打开 Ride， 选 择 菜单 栏 File 一 New Project, fE: Name 文本 框 中 输 
入 项 目 名 称 ， 此 处 Type 我 们 选择 Directory， 单 击 OK 按钮 ， 即 可 创建 成 功 ， 如 图 1-1-2 所 示 。 


Np — 
Name Type 
D Fle ®© Directory 

Parent Directory F:\project\RobotFrameworkTest1 Browse 
| 
| 
| 
| Le ][ e= J 

图 1-1-2 


存储 格式 支持 多 种 类 型 ， 如 表 1-1-1 所 示 。 
表 1-1-1 存储 格式 支持 的 类 型 


储存 类 型 


项 目 存储 方式 : 文件 形式 或 者 目录 形式 ， 一 般 建议 选择 目录 形式 


文件 存储 格式 ， 提 供 了 ROBOT (默认 格式 ) 、TXT、TSV 和 HTML 四 种 格式 


1.1.2 创建 测试 套件 


选择 上 面 我 们 创建 好 的 项 目 ， 右 击 鼠 标 键 ， 选 择 New Suite 选项 ， 输 入 测试 套件 名 称 ， 即 
可 创建 成 功 ， 如 图 1-1-3 所 示 。 


sais — aT 
M TestSutel Type 

9 He © Directory 
| 

Format. 
c MEEEESEOEE 000000008 

[Cor] (ence J 
图 1-1-3 
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1.1.3 创建 测试 用 例 


选择 上 面 我 们 创建 好 的 测试 套件 ， 右 击 ， 选 择 New Test Case 选项 ， 输 入 用 例 名 称 ， 单 击 
OK 按钮 ， 即 可 创建 成 功 ， 如 图 1-1-4 所 示 。 


New Test 
Name | 
Give a name for the new test case. 
C) 
1-1-4 
创建 成 功 后 ， 即 可 看 到 下 面 的 用 例 编 写 表 格 ， 如 图 1-1-5 所 示 。 通 过 此 表格 ， 我 们 就 可 以 


编写 测试 用 例 了 。 


图 1-1-5 


1 .2 Robot Framework 基础 关键 字 


1.2.1 如 何 搜索 Robot Framework 的 关键 字 
有 两 种 方式 可 以 快速 地 打开 RIDE 的 关键 字 搜 索 对 话 框 。 


(1) 选择 菜单 栏 中 的 Tools 一 Search Keywords 选项 ， 然 后 会 出 现 如 图 1-2-1 所 示 的 关键 
字 搜 索 对 话 框 ， 这 个 对 话 框 就 类 似 于 提供 了 一 个 关键 字 的 API 功能 (提供 了 关键 字 的 名 称 、 
关键 字 的 来 源 库 、 关 键 字 的 使 用 描述 和 关键 字 的 参数 ) 。 
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Search term: | Q | [V Search documentation 
Source: | <all keywords» >J 

Name Source Description ^ 
Call Method Builtin Calls the named method of the given object with the ... 3 
Catenate Builtin Catenates the given items together and returns the r... 
Comment Builtin Displays the given messages in the log file as keywor... 
Continue For Loop Builtin Skips the current for loop iteration and continues fro... 
Continue For Loop If BuiltIn Skips the current for loop iteration if the "condition"... 
Convert To Binary Builtin Converts the given item to a binary string. 
Convert To Boolean BuiltIn. Converts the given item to Boolean true or false. 
Panne T+ man- miar Kanana achuma EAT V pp PP TEN 30 

Name: CalMethod E 

Source: BuiltIn «test library> 

Arguments: [ object | method name | “args | **kwargs ] 3 

Cals the named method of the given object with the provided arguments. 

The possible return value from the method is returned and can be assigned to a variable. Keyword fails both if the 

object does not have a method with the given name or if executing the method raises an exception. 

Support for **kwargs is new in Robot Framework 2.9. Since that possible equal signs in other arguments must be 5 

pensi uith -hnrbrheh Wen 一 

Find Usages 


图 1-2-1 
(2) 直接 按 FS 快捷 键 ， 就 可 以 自动 弹出 我 们 需要 的 关键 字 搜索 框 。 


1.2.2 HEF log 


Log 关键 字 其 实 就 等 同 于 Python 语言 中 的 print 函数 ， 可 以 输出 我 们 想 要 输出 的 内 容 (也 
就 是 我 们 在 编程 语言 中 常 说 的 日 志 输出 )， 比 如 我 们 在 test case 中 输入 如 图 1-2-2 所 示 的 内 容 。 


图 1-2-2 


勾 选 我 们 的 测试 用 例 ， 单 击 菜单 栏 Tools Run Tests (或 者 直接 快捷 键 F8 ) 来 执行 这 条 测 
试用 例 ， 如 图 1-2-3 所 示 。 


cooREBHKT » © 


ow | Edit | Text Edit | Run | Log | Manage Plugins | 
日 -| ` TestSutel 
器 Y Testcase001] TestCase001 
EÊ External Resources Em 
1 Hello RobotFramework 
2 
图 1-2-3 


执行 完成 后 ， 切 换 到 Run 标签 ， 可 以 看 到 用 例 执行 的 结果 。 通 过 运行 结果 可 以 看 到 输出 
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了 我 们 想 要 输出 的 信息 INFO : Hello RobotFramework， 如 图 1-2-4 所 示 。 


TestCase001 | PASS | 


RobotFranevorkTest1 .TestSuitel | Pass | 
1 critical test, 1 passed, 0 failed 
1 test total, 1 passed, 0 failed 


RobotFrameworkTesti | Pass | 
1 critical test, 1 passed, 0 failed 
1 test 0f 


Output: c:\users\yongqing\appdata\local\temp\RIDE4nytoe. d\output xa] 
Log C: Nusers\yongqing\appdata\local\teap\RIDE(nytoe.d\log. htal 

Report: c:\users\yongqing\appdata\local\temp\RIDE¢nytoe .d\report htal 
test finished 20170304 23:05:49 


Starting test: RobotFramevorkTestl.TestSuitel.TestCase001 
20170304 23:05:49.671 : INFO : Hello RobotFranevork 
Ending test RobotFramevorkTest1.TestSuitel TestCase001 


图 1-2-4 


1.2.3 ”如 何在 用 例 中 定义 一 个 变量 


我 们 可 以 通过 Set Variable 来 定义 一 个 变量 ， 比 如 我 们 定义 一 个 变量 varl， 并 且 将 这 个 变 
量 赋值 为 Robot， 然 后 将 这 个 变量 用 log 输出 ， 如 图 1-2-5 所 示 。 


1-2-5 


1 critical test, 1 passed. 

1 test total, 1 passed, 0 f 

RobotFrameworkTesti | PASS 
1 critical test, 1 passed. D failed 

1 test total. 1 passed, 0 failed 


Output: c'^users'yongqing*appdata*localtemp*RIDE4nytoe d'output xal 
Log ¢/\users\yongqing\appdata\ local \temp\RIDE4nytoe d\log html 
Report; c:\users\yongqing\appdata\local \temp\RIDEdnytoe.d\report html 
test finished 20170304 23:16:32 
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1.24 如 何 快速 查询 某 一 个 关键 字 的 API 说 明 


选中 关键 字 ， 同 时 按 住 Ctrl+Alt 组 合 键 ， 即 可 显示 该 关键 字 的 帮助 API 以 及 使 用 示例 ， 
如 图 1-2-7 所 示 。 
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1.2.5 如何 快速 补 全 关键 字 


通过 键盘 输入 关键 字 的 前 绥 ， 然 后 同时 按 住 Ctrl+Alt+ 空 格 键 ， 即 可 快速 补 全 某 个 关键 字 ， 
如 图 1-2-8 所 示 。 


图 1-2-8 


1.2.6 如何 定义 一 个 列表 


此 处 我 们 说 的 列表 ， 其 实 就 等 同 于 Python 语言 中 的 列表 ， 是 Python 语言 中 常用 的 一 种 数 
据 结 构 ， 也 类 似 于 Java 语言 中 的 List。 

在 Robot Framework 中 ， 我们 可 以 使 用 Create List 来 创建 一 个 列表 ， 比 如 我 们 定义 一 个 列 
表 1listl， 并且 在 创建 列表 时 就 添加 3 个 元 素 。 然 后 使 用 log 关键 字 将 这 个 列表 中 的 元 素 全 部 输 
出 ， 如 图 1-2-9 所 示 。 
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@{listl} Create List hello robot framework 
log ${list1} 


1 |@0st1y Create List hello robot framework 
2 [iog süsti) 
1-2-9 


执行 结果 如 图 1-2-10 所 示 。 


Starting test: RobotFrameworkTestl.TestSuitel.TestCase 

20170305 22:53:44.087 INFO : @{list1} = [ hello | Too | framework ] 
20170305 22:53:44.089 : INFO : [u'hello', u'robot', u'framework'] 
Ending test RobotFrameworkTestl.TestSuitel.TestCaáse2 


图 1-2-10 


1.2.7 ”如 何 定义 一 个 字典 


此 处 我 们 说 的 字典 其 实 就 等 同 于 Python 语言 中 的 字典 ， 和 列表 一 样 ， 字 典 也 是 Python is 
言 中 非常 常用 的 一 种 数据 结构 ， 也 类 似 于 Java 语言 中 的 Map。 

在 Robot Framework 中 ， 使 用 Create Dictionary 来 创建 一 个 字典 ， 比 如 我 们 定义 一 个 字典 
Dictl， 并 且 在 创建 字典 时 就 添加 两 个 键 值 对 ， 然 后 使 用 Log Many 关键 字 将 这 个 字典 中 的 内 
容 全 部 输出 ， 如 图 1-2-11 所 示 。 

Log Many 关键 字 类 似 于 log 关键 字 ， 不 同 的 是 log 关键 字 只 可 以 接收 一 个 参数 ， 而 Log 
Many 关键 字 可 以 同时 接收 多 个 参数 。 


&(Dictl) Create Dictionary a-hello b-robotframework 
Log Man &(Dictl) 
1 J&bicti) Create Dictionary a-hello b=robotframework 
2 |Log Many &(Dict1) 
图 122-11 


执行 结果 如 图 1-2-12 所 示 。 


Starting test: RobotFramevorkTestl.TestSuitel.TestCase003 

20170305 23:23:49.439 INFO : &(Dictl) = ( a-hello | b=robotframevork ) 
20170305 23:23:49.439 INFO : a-hello 

20170305 23:23:49.439 INFO : b=robotfranework 


Ending test RobotFranevorkTest1.TestSuitel .TestCase003 


图 1-2-12 


1.2.8 ”如何 拼 接 两 个 字符 串 


我 们 可 以 通过 Catenate 来 拼接 字符 串 ， 比 如 将 “Hello” 和 “Robot” 这 两 个 字符 串 拼 接 起 
来 并 且 输 出 ， 如 图 1-2-13 所 示 。 


${val2} Catenate Hello Robot 
log ${val2} 
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S(val2) Catenate Hello Robot 


log $(val2) 


(SIE 
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执行 结果 如 图 1-2-14 所 示 。 


RobotFrameworkTestl.TestSuitel.TestCase004 
INFO : ${val2} = Hello Robot 
INFO : Hello Robot 


Starting test: 
20170305 23:31:25.665 : 


Ending test: RobotFrameworkTest1.TestSuitel .TestCase004 
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1.2.9 如 何 使 用 for 循环 
不 管 在 哪 种 编程 语言 中 ，for 循环 都 是 必 不 可 少 的 。 在 Robot Framework 中 ， 我 们 也 可 以 


使 用 for 循环 来 做 遍历 处 理 。 
我 们 可 以 用 for 循环 对 一 个 列表 进行 遍历 ， 并 且 输 出 该 列表 中 的 每 一 个 元 素 。 例 如 ，list2 
中 有 a、b、c、d 四 个 元 素 ， 循 环 遍历 输出 这 些 元 素 ， 如 图 1-2-15 所 示 。 


@{list2} Create Lista b 


:FOR ${value} in @{list2} 
log ${value} 


Ct Create List a b 
FOR S(value) n at 
log sabe) 


Starting test: RobotFrameworkTest1.TestSuitel .TestCase005 
20170307 23:18:13.430 : @{list2} =[albl]cl|ld] 
23:18:13.430 : 0 
23:18:13.430 
23:18:13.430 
23:18:13.430 : 
Ending test RobotFrameworkTestl.TestSuitel.TestCase005 


图 1-2-16 


1.2.10 如何 中 断 for 循环 


我 们 可 以 使 用 Exit For Loop 下 关键 字 来 中 断 一 个 for 循环 。 例 如 ，list2 £ a, b. c. d 
个 元 素 ， 循 环 遍历 输出 这 些 元 素 ， 当 输出 到 元 素 c 时 跳出 这 个 循环 ， 如 图 1-2-17 所 示 。 


@{list2} Create List a b c d 
:FOR ${value} in @{list2} 

log ${value} 

Exit For Loop If 'S{value}'=='"c' 
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1 et Create List la b c d 
(2 FoR {value} n eta 
3 log $(value) 
4 ] | Exit For Loop If "(value - c 
图 1-2-17 


Starting test: RobotFrameworkTestl.TestSuitel.TestCase006 
20170307 23:26:50.877 : INFO : @{list2} =[ a| b | c | dá J 
20170307 23:26:50.877 : INFO : a 

20170307 23:26:50.893 : INFO : b 

20170307 23:26:50.893 : INFO : c 

20170307 23:26:50.893 : INFO : Exiting for loop altogether. 
Ending test: RobotFraneworkTestl.TestSuitel.TestCase006 
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1.2:44. Run Keyword If 判断 的 使 用 

Run Keyword 开 是 一 个 常用 的 用 来 做 逻辑 判断 的 关键 字 , 意思 是 如 果 满 足 了 某 一 个 判断 条 
件 ， 就 会 执行 关键 字 。 我 们 在 list3 中 放 入 0、1、2 三 个 元 素 ， 然 后 遍历 list3， 判 断 当 取 到 元 
素 0 时 ， 输 出 “男生 ”， 如 图 1-2-19 所 示 。 


@{list3} Create List 0 1 
:FOR ${value} in @{list3} 


Run Keyword If '$(value)'- ='0' log 男生 
1 [ene Create List 0 1 2 
2 :FOR Sfvalue} n est) 
3 Run Keyword If "S(vaue) e" log 男生 
4|- 
图 1-2-19 
执行 结果 如 图 1-2-20 所 示 。 


Starting test: RobotFrameworkTestl.TestSuitel.TestCase007 
20170308 00:00:18.569 : INFO: eiie =[0| 112] 


20170308 00:00:18.569 INFO 
Ending test: RobotFrameworkTest1.TestSuitel .TestCase007 


图 1-2-20 


1.2.12 Comment 关键 字 的 使 用 


Comment 关键 字 是 用 来 做 注释 使 用 的 ， 和 很 多 编程 语言 中 的 注释 作用 一 样 ， 可 以 用 来 临 
时 注释 掉 某 一 行 自动 化 脚本 ， 让 其 暂时 不 运行 ， 也 可 以 用 来 做 解释 说 明 使 用 ， 如 图 1-2-21 所 
示 。 

TE Robot Framework 的 RIDE 中 , 可 以 选中 某 一 行 脚本 , 右 击 鼠标 键 , 选择 Comment Rows 
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选项 ， 然 后 可 以 对 选中 的 那 一 行 脚本 做 注释 ， 注释 完 成 后 ， 这 一 行 脚本 将 不 会 再 被 运行 。 


1-2-21 


如 果 需 要 取消 注释 ， 右 击 鼠标 键 ， 选 择 Uncomment Rows 选项 即 可 。 注 释 取消 后 ， 在 用 例 
运行 时 ， 没 有 被 注释 的 脚本 就 会 被 运行 ， 如 图 1-2-22 Ara. 


Ctrl-I 
Ctrl-D 
Ctrl-3 
Ctrl-4 
Move Rows Up Alt-Up 
Move Rows Down Alt-Down 


Insert Rows 
Delete Rows 
Comment Rows 


图 1-222 


1.2.13 Return From Keyword 和 Return From Keyword If 关键 字 的 使 用 


Return From Keyword 关键 字 和 很 多 编程 语言 中 的 retum 关键 字 一 样 ， 具 有 如 下 鲜明 的 特 
点 : 


CD 脚本 执行 到 该 关键 字 后 ， 会 直接 返回 ， 不 会 再 执行 后 面 的 脚本 。 

(2) 返回 时 会 带 有 对 应 返回 值 。 调 用 者 可 以 通过 不 同 的 返回 值 来 建立 不 同 的 判断 分 支 。 

(3) Return From Keyword 关键 字 一 般 用 于 用 户 自 定义 关键 字 中 。 用 户 自 定义 关键 字 相 当 
于 是 用 系统 已 有 的 关键 字 来 封装 出 一 个 新 的 关键 字 。 

(4) Retum From Keyword If 关键 字 用 寺 条 件 来 进行 判断 ， 当 满足 指定 的 过 条 件 后 , 就 执 
ff return 返回 。 返 回 时 和 Return From Keyword 关键 字 一 样 ， 可 以 指定 返回 的 具体 值 。 


【示例 】 我 们 编写 了 一 个 自 定义 关键 字 , 其 中 定义 了 一 个 入 参 ${valueReturn}, 如 图 1-223 
所 示 ， 然 后 通过 执行 Return From Keyword If '${value}'=='$ {valueRetum}' ${value} 来 判断 我 
们 需要 返回 的 值 ， 如 图 1-2-24 所 示 。 
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Arguments S(valueReturn)] 


Comment 


| Specify the arguments separated with a pipe character like '$(arg1) | ${arg2)'. 
Default values are given using equal sign and the last argument can be a list variable. 
Example: '${arg1} | ${arg2}=default value | @{rest}'. 
Note. You can use variable shortcuts in this field. 
Possible pipes in the value must be escaped with a backslash like \|'. 


Ce J[ ene ) 


图 1-223 


@{list2} Create List 1 2 3 
:FOR ${value} IN @{list2} 

Return From Keyword If '$(value]'--'$(valueReturn)"' ${value} 
Return From Keyword ${value} 


1 2 
S(velue) IN @(hst2) 


图 1-2-24 
自 定义 关键 字 完 成 后 ， 就 可 以 调用 了 ， 如 图 1-2-25 所 示 。 
{result} Example Return From Keyword 4 
log S(result) 
图 1-225 


执行 结果 如 图 1-2-26 所 示 。 


Starting test: RobotFrameworkTestl.TestSuitel.TestCase030 
20180924 11:44:12.210 : INFO : @{list2} = [112 | 314] 
20180924 11:44:12.219 : INFO : Returning from the enclosing user keyword. 


20180924 11:44:12.221 : INFO : ${result} = 4 
20180924 11:44:12.222 : INFO : 4 
Ending test: | RobotFrameworkTestl.TestSuitel.TestCase030 


图 1-2-26 


从 执行 结果 可 以 看 到 ， 在 调用 Example Return From Keyword 这 个 自 定义 关键 字 时 ， 我 们 
传 入 的 入 参 为 4， 按 照 自 定义 关键 字 中 的 判断 逻辑 返回 4。 
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Robot Framework 断言 关键 字 


1.3.1 Should Be Equal 关键 字 的 使 用 


Should Be Equal 关键 字 一 般 用 来 判断 实际 结果 是 否 和 预期 结果 相等 。 例 如 ， 我 们 将 变量 
${value} 的 值 设置 为 1， 使 用 Should Be Equal 关键 字 来 判断 ${value} 是 否 等 于 2， 若 断言 失败 ， 
则 输出 实际 值 为 ${value}， 和 预期 不 符合 ， 如 图 1-3-1 所 示 。 


${value} Set Variable i 
Should Be Equal${value} 2 ”实际 值 为 ${value}， 和 预期 不 符合 


${value} Set Variable 1 
Should Be Equal ${value} 2 实际 值 为 Sfvalue}， 和 预期 不 符合 


执行 结果 如 图 1-3-2 所 示 。 


Starting test: RobotFrameworkTest1 S TestCase011 
20170402 13:23:43.228 : INFO : ${value} = 


20170402 13:23:43.228 FAIL : 实际 值 为 1， HATEG: 1 l= 2 
Ending test: RobotFranevorkTesti TestSuitel.TestCase011 


1-32 


1.8.2 Should Be True 关键 字 的 使 用 

Should Be True 关键 字 用 来 判断 返回 值 是 否 为 True， 例 如 我 们 将 变量 $ fvalue} 的 值 同 样 设 
置 为 1， 使 用 Should Be True 关键 字 对 表达 式 '$ {value}'=='2' 进行 True 和 False 的 判断 ， 由 于 
我 们 设置 的 值 为 1， 因 此 很 明显 会 判断 失败 ， 如 图 1-3-3 所 示 。 


${value} Set Variable 1 
Should Be True '$š(value)'=='2' 判断 失败 


${value} Set Variable 1 
Should Be True ‘s{value}'==" 判断 失败 
1-3-3 


执行 结果 如 图 1-3-4 所 示 。 


Starting test: RobotFrameworkTest1.TestSuitel .TestCase012 
20170402 13:30:58.719 INFO : Mr? 


20170402 13:30:58.719 : FAIL 判断 失 : 
Ending test: RobotFrameworkTestl.TestSuitel.TestCase012 


1-3-4 
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1.3.3 Should Contain 关键 字 的 使 用 


Should Contain 关键 字 用 来 判断 某 个 字符 串 中 是 否 包含 了 我 们 预期 需要 的 字符 或 者 字符 
AB, 例如 我 们 将 变量 ${fstr} 的 值 设 置 为 Robot Framework, 使 用 Should Contain 关键 字 来 判断 $ {str} 
是 否 包含 “Hello” 这 个 字符 串 。 很 明显 ， 我 们 执行 的 结果 肯定 会 判断 失败 ， 如 图 1-3-5 所 示 。 


${str} Set Variable RobotFramework 
Should Contain ${str} Hello ¥##${str} PAW Hello 


sistr} Set Variable RobotFramework 
Should Contain S{str} Hello 字符 串 ${str} 中 不 包 合 Hello 
1-3-5 


执行 结果 如 图 1-3-6 所 示 。 


Starting test: RobotFramevorkTestl.TestSuitel.TestCase013 
20170402 13:44:52.194 INFO ; $(str) = RobotFramework 


20170402 13:44:52.194 FAIL : 字符 串 RobotFranework 中 不 包含 He11o: 'RobotFramework' does not contain ‘Hello’ 
Ending test RobotFranevorkTest1.TestSuitel.TestCase013 


1-3-6 


1.83.4 Should End With 关键 字 的 使 用 


Should End With 关键 字 用 来 判断 某 个 字符 串 是 否 以 我 们 预期 指定 的 字符 串 来 结束 ， 例 如 
我 们 同样 将 变量 ${str} 的 值 设 置 为 RobotFramework, 使 用 Should End With 来 判断 ${str} 是 不 是 
以 “Hello” 这 个 字符 串 来 结束 。 很 明显 ， 我 们 执行 的 结果 肯定 会 失败 ， 如 图 1-3-7 所 示 。 


${str} Set Variable RobotFramework 
Should End With${str} Hello F##H#S${str} PAV Hello 来 结束 


${str} Set Variable RobotFramework 
Should End With Sst} Hello 字符 串 $fstr} 中 不 以 Hello 来 结束 
图 1-3-7 


执行 结果 如 图 1-3-8 所 示 。 


Starting test: RobotFranevorkTest1.TestSuitel TestCase014 

20170402 13:39:15.737 : INFO : ${str} = RobotFranevork 

20170402 13:39:15.737 FAIL 2; r EROBOL E EROSO E T: i 'RobotFramevork' does not end with 'Hello' 
Ending test: RobotFranevorkTest1.TestSuitel .TestCasel1 


图 1-3-8 
当 我 们 将 “Hello ”字符 串 换 成 “work ”后 ， 再 执行 一 下 ， 会 发 现 执行 成 功 ， 因 为 
RobotFramework 是 以 work 来 结尾 的 ， 如 图 1-3-9 所 示 。 


${str} Set Variable RobotFramework 
Should End With${str} work 字符 串 S{str} 中 不 以 Hello 来 结束 
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{st} Set Variable RobotFramework 
Should End With sistr} work 字符 串 $fst} 中 不 以 Hello 来 结束 
1-3-9 


执行 结果 如 图 1-3-10 所 示 。 


RobotFraneworkTest1 TestSuitel 
1 critical test, 1 passed. 0 failed 

1 test total. 1 passed, 0 failed 

RobotFrameworkTest1 | PASS | 
1 critical test. 1 passed. 0 failed 

1 test total. 1 passed. 0 failed 

Output: c:\users\yongging\appdata\local\teap\RIDEwvfdéy.d\output . xml 

Log C: users \yongqing\appdatas local \tenp\RIDEwvfdéy d\log.htal 

Report: c:\users\yongqing\appdata\local\teap*RIDEwvfdéy d\report htal 


test finished 20170402 13:48:07 


Starting test: RobotFranevorkTest1.TestSuitel TestCase014 
20170402 13:48:07.311 : INFO : $(str) = RobotFranevork 
Ending test: — RobotFramevorkTestl TestSuitel TestCase014 


图 1-3-10 


13.5 其 他 常用 断言 关键 字 


除了 我 们 上 面 列 出 的 关键 字 外 ，Robot Framework 中 还 提供 了 大 量 其 他 的 断言 关键 字 ， 如 
表 1-3-1 所 示 。 


表 1-3-1 其 他 常用 断言 关键 字 
描述 
判断 是 否 为 空 ， 若 不 为 空 ， 则 执行 失败 ， 示 例 : 


Set Variable 
Should Be Emp 结果 不 为 空 


断言 关键 字 
Should Be Empty 


Should Start With | 判断 某 个 字符 串 是 否 以 预期 执行 的 字符 串 开 始 ， 若 以 指定 的 字符 串 开 头 ， 则 执行 成 
功 ， 否 则 执行 失败 ， 示 例 : 
$ {value} Set Variable | Hello 
Should Start With S (value) 字符 串 S{value} 不 以 qq 开头 


与 Should Start With 刚好 相反 ， 若 以 指定 的 字符 串 开 头 ， 则 执行 失败 ， 否 则 执行 成 功 ， 
示例 : 


Should Not Start 
With 


$ {value} Set Variable Hello 
Should Not Start With S {value} qq FFF HS {value} E: VA qq FA 
Should Match 判断 某 个 字符 串 是 否 与 预期 指定 的 字符 串 相 匹配 ， 若 可 以 匹配 ， 则 执行 成 功 ， 否 则 执 
行 失败 ， 示 例 : 
$ {value} Set Variable Hello 
Should Match $ {value 字符 串 ${fvalue} 不 可 以 匹配 qq 
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(BER) 
断言 关键 字 描述 
Should Not Match 与 Should Match 刚好 相反 ， 若 字符 串 匹 配 ， 则 执行 失败 ， 否 则 执行 成 功 ， 示 例 : 
$ {value} Set Variable Hello 
Should Match ${value} Hello | 字符 串 $fvalue} 可 以 匹配 


hello 


Should Contain X 
Times 


与 Should Contain 关键 字 类 似 , 用 来 判断 指定 的 字符 串 包含 指 定 的 字符 或 者 字符 串 多 
少 次 ， 示 例 : 


$ {value Set Variable hello 
Should Contain X | ${value} hello 3 S$fvalue} 中 没有 3 次 包含 字 
= ZEE hello 


Should Be Equal As 
Integers 


Should Be Equal As 
Strings 


Should Be Equal As 
Numbers 


Should Not Be Equal 


Should Not Be Empty 


以 整数 的 形式 来 进行 比较 ， 示 例 ， 
Should Be Equal As Integers 


以 字符 串 的 形式 来 进行 比较 ， 示 例 : 
| stva) |sevaiove [a | 
q 和 13 不 相等 


以 number 的 形式 来 进行 比较 ， 示 例 : 
| stva} | Set Variable [io | 
Should Be Equal AsNumbers [stam] — |i 1.0 F 1 


与 Should Be Equal 用 法 相反 ， 当 带 比 较 的 两 个 值 相等 时 ， 执 行 失败 ， 理 则 执行 成 功 ， 
示例 : 

| sivatuey | Set Variable Jio | 

| shouldNotBeEqual — [sea a — [io | 1.0 F 1.0 


与 Should Be Empty 用 法 相反 ， 若 为 空 ， 则 执行 失败 ， 示 例 : 
FHRS value) H 


12 和 13 不 相等 


BuiltIn 库 剩余 关键 字 


14.1 常用 转换 类 型 关键 字 
Robot Framework 中 提供 了 很 多 类 型 转换 关键 字 ， 如 表 1-4-1 所 示 。 


表 1-4-1 
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常用 转换 类 型 关键 字 


转换 类 型 关键 字 描述 
将 指定 的 内 容 转 换 为 二 进 制 形式 ， 示 例 : 
${value} Set Variable | 12 
Convert To Binary ? 
${newvalue} Convert To Binary | ${value} 
Lo; S(newvalue 


Convert To Boolean 


将 指定 的 内 容 转换 为 布尔 类 型 ， 示 例 ; 


${newvalue} 


Set Variable 


Convert To Boolean 


12 
${value} 


Log 


${newvalue} 


Convert To Bytes 


Convert To Hex 


Convert To Integer 


Convert To Number 


将 指定 的 内 容 转换 为 字 节 数 ， 


示例 : 


${newvalue} 


将 指定 的 内 容 转换 为 Integer 形式 ， 示 例 : 


将 指定 的 内 容 转换 为 十 六 进 制 形式 ， 示 例 ; 


Set Variable 
Convert To Hex 


${newvalue} 


Set Variable 
Convert To Integer 


Set Variable 
Convert To Number 


将 指定 的 内 容 转换 为 八进制 形式 ， 示 例 : 


$ {value} 


$ {value} Set Variable 12 
Convert To Octal 

${newvalue} Convert To Octal ${value} 

Log ${newvalue} 

将 指定 的 内 容 转 换 为 字符 串 形式 ， 示 例 : 
ñ ${value} Set Variable 12 

Convert To String ” 

${newvalue Convert To String ${value 


Log 


${newvalue} 


142 ”常用 Get 类 型 关键 字 
表 1-4-2 中 列 出 了 Get 类 型 关键 字 的 常用 用 法 。 
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表 1-4-2 Get 类 型 关键 字 的 常用 用 法 


Get Variable Value 


Get Variables 


Get 类 型 关键 字 描述 
获取 某 个 字符 串 包含 指定 字符 或 者 字符 串 的 次 数 ， 示 例 : 
${value} Set Variable hellohello | 
Get Count 
${count} Get Count S${value} | hello 
Set Variable hellohello 
Get Length 
$ {length} Get Length ${value} 
log $ {length} 
获取 时 间 ， 示 例 : 
Get Time ${time Get Time format=timest: 


获取 指定 变量 的 值 ， 示 例 : 


Set Variable 
Get Variable Value 


获取 所 有 的 环境 变量 ， 示 例 : 
S$ {vars Get Variables 


lo; S {vars, 


14.3 ”常用 Import 类 型 关键 字 
表 1-4-3 中 列 出 了 Import 类 型 关键 字 的 常用 用 法 。 


表 1-4-3 Import 类 型 关键 字 的 常用 用 法 


Import 类 型 关键 字 “| 描述 
Import Library 在 用 例 中 导入 某 个 Library 库 ， 示 例 : 

ort Libr: DatabaseLib: 
Import Resource 在 用 例 中 导入 某 个 Resource 文件 ， 示 例 : 

ort Resource d:\\RUNNING. txt 
Import Variables 在 用 例 中 从 文件 导入 变量 ， 示 例 : 

ort Variables variables, 


144 ”常用 Set 类 型 关键 字 
表 1-4-4 中 列 出 了 Set 类 型 关键 字 的 常用 用 法 。 
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R144 Set 类 型 关键 字 的 常用 用 法 


Set 类 型 关键 字 描述 


设置 日 志 级 别 ， 示 例 : 
Set Log Level | DEBUG 


Set Log Level 


根据 判断 条 件 的 结果 来 确定 给 某 个 变量 赋值 ， 示 例 : 
Set Variable If $ {value} Set Variable If 22r 0 
log ${value} 
设置 全 局 变量 ， 使 得 该 变量 也 可 以 在 别 的 用 例 中 使 用 ， 示 例 : 
Set Global Variable Set Global Variable ${book} robotframework 
lo; $ {book 


14.5 ”常用 Run Keyword 类 型 关键 字 
表 1-4-5 中 列 出 了 Run Keyword 类 型 关键 字 的 常用 用 法 。 
表 1-4-5 Run Keyword 类 型 关键 字 的 常用 用 法 
Run Keyword 类 型 关键 字 “| 描述 


Run Keyword 执行 某 个 关键 字 ， 示 例 : 
[Runkeyword [iog | RobotFramework 
Run Keywords rM 示例 : 
Run ${book} | robotframework $ {book} 
Keywords | Global 
Variable 
Run Keyword And Return Run Keyword And Retum 和 上 面 介绍 的 Return From Keyword 和 Retum From 


Keyword If 这 两 个 关键 很 类 似 ， 必 须要 包装 在 用 户 自 定义 关键 字 中 使 用 ， 主 要 
用 于 执行 一 个 指定 关键 字 并 且 返 回 结果 ， 接 收 [ name | *args ] 多 个 参数 ， 示 例 : 
首先 需要 定义 一 个 用 户 自 定义 关键 字 ， 自 定义 关键 字 的 名 称 为 
Example RUN Keyword AND_RETURN， 关 键 字 里 面 的 内 容 如 下 ; 


| Run Keyword And Retum [tog | robotframework 
之 后 新 建 一 个 案例 ， 调 用 该 定义 用 户 关键 字 : 
Example RUN Keyword AND RETURN 


146 ”其 他 关键 字 
表 1-4-6 中 列 出 了 BuiltIn 库 中 剩余 其 他 关键 字 的 用 法 。 
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表 1-4-6 Builtin 库 中 剩余 其 他 关键 字 的 用 法 


Wait Until Keyword 
Succeeds 


Pass Execution 


Replace Variables 
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关键 字 描述 
Evaluate 调用 Python 中 给 定 的 表达 式 ， 并 且 返 回 结果 ， 示 例 : 
${valuel} Evaluate int(3)+int(4) 
Log ${valuel} 
Fail 指定 某 个 测试 用 例 在 执行 某 个 步骤 时 直接 判定 执行 失败 ， 示 例 : 
Fail [ 执行 失败 
Sleep 按照 指定 的 时 间 休 卢 等 待 ， 示 例 : 
Sleep 3s 
Variable Should Exist | 判断 某 个 变量 是 否 存在 ， 若 变量 存在 ， 则 执行 成 功 ， 否 则 执行 失败 ， 示 例 : 
Variable Should Exist S{value} | 变量 不 存在 
Variable Should not| 和 Variable Should Exist 用 法 相反 ， 若 变量 存在 ， 则 执行 失败 ， 否 则 执行 成 功 ， 示 例 : 
Exist S value 12 
Variable Should not Exist 变量 存在 


在 等 待 的 时 间 内 ， 若 关键 字 执行 失败 ， 则 按照 每 隔 指定 的 时 间 重 新 执行 ， 若 超出 等 竺 
的 时 间 还 执行 失败 ， 则 执行 失败 ， 示 例 : 


Wait Until Keyword Succeeds Variable Should Exist 


使 用 PASS 状态 跳 过 当前 的 测试 ， 示 例 : 


Pass Execution Deprecated test. 


变量 痊 换 ， 示 例 ， 
Set Variable [neo | 
Replace Variables 


| stresy lm | 


s= 2 = 


Robot Framework 
对 数据 库 的 操作 


DatabaseLibrary 库 的 使 用 


在 自动 化 过 程 中 ， 我 们 经 常 需要 连接 不 同 的 数据 库 ， 并 且 对 数据 库 进 行 很 多 不 同 的 操作 。 
Robot Framework 提供 了 DatabaseLibrary 库 来 操作 数据 库 。 我 们 可 以 按照 官网 中 的 说 明 来 安装 
DatabaseLibrary 库 。 在 浏览 器 中 访问 http://franz-see.github.io/Robotframework-Database-Library/ 
页 面 ， 即 可 看 到 该 库 的 相关 安装 说 明和 API 介绍 ， 如 图 2-1-1 所 示 。 


Robotframework- 
Database-Library .,+....... 


Database Library contains utilities meant for Robot Framework s usage. This 
can allow you to query your database after an action has been made to 
verify the results. This is compatible* with any Database API Specification 
20 module 


API 


2-1-1 
可 以 通过 在 命令 行 中 执行 pip install -U robotframework-databaselibrary 来 进行 安装 。 安 装 完 
成 后 ， 在 使 用 DatabaseLibrary 库 时 ， 需 要 预先 在 测试 套件 中 导入 该 库 ， 如 图 2-1-2 所 示 。 这 里 
以 MySQL 数据 库 为 例 ， 讲 述 DatabaseLibrary 库 的 使 用 。 
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TestSuite2 
Source F:\project\RobotFrmeworkTest! \RobotFrameworkTestt\TestSute2. bt 
Import Name / Path Arguments Comment Add Import 
[library Databaselibrary Library 
Resource 
Varables 
Import Failed Help 


2-1-2 
要 连接 到 MySQL, 除了 要 导入 DatabaseLibrary 库 外 , 还 需要 安装 pure-Python MySQL client 
library， 可 以 通过 访问 网 址 :https://github.com/PyMySQL/PyMySQL 下 载 该 库 并 且 进 行 安装 ， 
或 者 直接 在 cmd 命令 行 中 输入 pip install PyMySQL 来 进行 安装 ， 如 图 2-1-3 所 示 。 


>pip install PyM 


2-1-3 


2.1.1 如 何 连 接 数 据 库 


(1) 可 以 通过 DatabaseLibrary 库 中 的 Connect To Database 关键 字 来 连接 一 个 MySQL 数 
据 库 。 此 处 以 连接 本 机 MySQL 库 为 例 ， 如 图 2-1-4 所 示 。 


@ 数据库 用 户 名 : root. 

© 数据 库 密 码 : root. 

© MySQL 数据 库 端口 : 3306. 
© XE: world. 


Connect To Database pymysql world root root localhost 3306 
Connect To Database pymysql world. root root localhost 3306 
图 2-1-4 


执行 结果 如 图 2-1-5 所 示 。 


DatabaseLibrary Connect To Database pymysql, world, root, root, localhost, 3306 


Documentation: Loads the DB API 2.0 module given 'dbapiModuleName' then uses it to 
Start / End / Elapsed: 20170311 13:35:10.455 / 20170311 13:35:10.517 / 00:00:00.062 
图 2-1-5 


(2) 还 可 以 通过 Connect To Database Using Custom Params 关键 字 来 连接 MySQL 数据 库 ， 
如 图 2-1-6 所 示 。 


Connect To Database Using Custom Params pymysql 


database-'world',user-'root', password-'root', host-'localhost', port=3306 
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[Connect To Database Using — pymysql database='world’, user=root’, 
[Custom Params ='rooť, 


host=localhost,, port=3306 
2-1-6 
执行 结果 如 图 2-1-7 所 示 。 
DatabaseLirary .Connect To Database Using Custom Params pymysql database- world, user="root’, password=root host=localhost’, port=3306 


Documentation: Loads the DB API 2.0 module given 'dbapiModuleName then uses itto 
Start/End/Elapsed: — 20170311 13:44:13.825 /20170311 13:44:13.887 / 00:00:00.062 


2-1-7 


2.1.2 ”如 何 断 开 数据 库 


可 以 通过 关键 字 Disconnect From Database 断 开 数据 库 连 接 ， 我 们 在 操作 数据 库 时 一 定 不 
要 忘记 在 操作 完成 后 断 开 数据 库 的 连接 ， 如 图 2-1-8 所 示 。 


Connect To Databasepymysql world root root localhost 3306 
Disconnect From Database 


‘Connect To Database pymysq word root root localhost 3306 
Disconnect From Database 


执行 结果 如 图 2-1-9 所 示 。 


= DatabaseUbrary.Connect To Database pymysql, world, root, root, localhost, 3306 
Documentation: Loads the DB API 2.0 module given 'dbapiModuleName' then uses it to 
Start / End / Elapsed: 20170311 13:38:35.589 / 20170311 13:38:35.651 / 00:00:00.062 


- Database Library .Disconnect From Database 
Documentation: Disconnects from the database. 
Start / End / Elapsed: 20170311 13:38:35.651 / 20170311 13:38:35.651 / 00:00:00.000 


图 2-1-9 


2.1.3 如何 对 数据 库 的 表 进 行 查询 


通过 Query 关键 字 可 以 对 数据 库 中 的 表 进 行 查询 。 此 处 以 查询 MySQL 数据 库 中 某 张 表 的 
数据 为 例 ， 我 们 在 world 数据 库 中 执行 “SELECT * FROM city LIMIT 5;” 这 条 SQL 语句 。 在 
SQL 窗口 中 查询 出 来 的 结果 如 图 2-1-10 所 示 。 
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1 SELECT * FROM city LIMIT 5 


文件 
[an +J) B 2 @ ë | Eee 
O| Name [Countrycode - Population - 
L —— ikaw AFG Kabol 1780000 
[m] 2 Qandahar AFG Qandahar 237500 
3 Berat — AFG Berat — | 186800 
4 Mazar-e-Sharif AFG Balkh | 127800| 
5 Amsterdam ‘NLD (Noord-Holland | 731200 
2-1-10 


然后 我 们 使 用 Query 关键 字 来 进行 查询 ， 如 图 2-1-11 所 示 。 


Connect To Database Using Custom Paramspymysql database-'world', user-'root', 
password-'root', host-'localhost', port=3306 


@{result} Query SELECT * FROM city LIMIT 5; 
Log Many @{result} 
Disconnect From Database 


Connect To Database Using — pymysql database='world’, user -'root', 
Custom Params password -'root', 
host='localhost’, port=3306 
G(result) Query SELECT * FROM city LIMIT 5; 
Log Many (result) 
Disconnect From Database 
图 2-1-11 


执行 结果 如 图 2-1-12 所 示 。 


DataboseLibrary Connect To Database Using Custom Params pymysq, database= World user'root', password=rcot, host=Tocalhost’, port=3306 000000 078| 
Jecumentation: Loads the DB API2 0 module given dbaolMcduleName then uses tt» 
tart /End | Elapsed: — 20170311 352:30.159 20170311 13:52:30237 /00:0000.078 

result) = DatstaseLivary Query SELECT * FROM city UMIT 5 00.00.00 000 
'ocumentation: Uses tne input 'selectStatement to query for he valves that 
tart /End| Elapsed: — 20170311 1362:20237 )2017031 


9:82:90 297 INFO alemde) = [ 0, "Xo, “AIG, 
'BAW, 127600) | ©, “Avsterdun’, "KI, ^. 


Buin.Log Many @(resuli} 0000.00.00) 


Qandahor’, 231900) | ©, ‘Herat’, NG ‘Herat’, 198900) | (4, "Iazu-e-Sharif', ‘AEG, 


jocumentation: Logs the given messages as separate entries using the INFO level. 
tart /End Elapsed: — 20170311 135230237120170311 135230237100000.000 
3:52:90 207 INFO (t, Kabul’, "ARG, “Kabol, 1780000) 


19:52:90 297 INFO, "Gendahar’, "A, "Qunlabar', 237500) 
3523027 INFO, Mes, 


3:52:90.297 INFO 5, “nsterda' ， MLD’, Jooré-kollane , 731200) 


图 2-1-12 


2.1.4 如 何 插入 和 删除 数据 
可 以 通过 Execute Sql String 关键 字 来 执行 数据 库 的 插入 操作 和 删除 操作 。 
COD 首先 我 们 来 看 一 下 如 何 向 数据 库 中 插入 数据 。 此 处 以 向 表 city 中 插入 一 条 记录 为 例 ， 
通过 Execute Sql String 关键 字 来 执行 INSERT INTO city(NAME.countrycode.district.population) 
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VALUESCbeijing' ,'ZH','China',217100) ， 如 图 2-1-13 所 示 。 


Connect To Database Using Custom Params pymysql database-'world', 
user-'root', password-'root', host="localhost', port=3306 

Execute Sql String INSERT INTO city (NAME, countrycode, district, population) 
VALUES ('beijing' ,'ZH','China',217100) 


Disconnect From Database 
Connect To Database Using pymysq| database='world’, user='root’, 
Custom Params password="root’, 
host='localhost’, port=3306 
Execute Sql String INSERT INTO 
Gty(NAME,countrycode, district,po} 
VALUES(beijing’ 
r ZH','China',217100) 
Disconnect From Database 


2-1-13 
执行 结果 如 图 2-1-14 所 示 。 


DatabeseLixary. Connect To Database Using Custom Params pymysq), database- world. user=root’. password=roof host=localhost’, port=3306 
Loads the DB API 2 0 module given 'dbapiModuleName' then uses itto 

20170311 14:11:04,375 /20170311 14:11:04 422 /00:00:00.047 

DatabaseLibrary Execute Sql String INSERT INTO city(NAME .countrycode district, population) VALUES (beijing ZH \China’.217100) 


Documentation: 
Start / End / Elapsed: 


Documentation: Executes the sqiString as SOL commands. 

Start / End | Elapsed: 20170311 14:11:04.422 / 20170311 14:11:04.422 / 00:00:00.000 
CELS Database Library Disconnect From Database 

Documentation: Disconnects from the database. 

Start / End | Elapsed: 20170311 14:11:04 422/ 20170311 14:11:04 422 / 00:00:00.000 


图 2-1-14 


在 SQL 窗口 查询 刚刚 执行 的 insert 语句 是 否 执行 成 功 。 我 们 可 以 看 到 已 经 成 功 插 入 了 数 
据 ， 如 图 2-1-15 所 示 。 


PET EXEI a jx 5 


mme -) 54585 EE 
=  [countzycoðe [District 
ing ZH China 


图 2-1-15 


(2) 然后 我 们 看 一 下 怎么 删除 表 中 的 数据 。 我 们 将 上 面 插入 的 “'beijing' ,'ZH','China’, 
217100” 这 条 数据 从 数据 库 中 删除 ， 如 图 2-1-16 所 示 。 


Connect To Database Using Custom Paramspymysql database-'world', user-'root', 
password-'root', host-'localhost', port=3306 

Execute Sql String delete from city where NAME-'beijing' 

Disconnect From Database 
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Connect To Database Using pymysql database='world’, user='root’, 
Custom Params password="root’, 
host-'localhost', port=3306 
Execute Sql String delete from city where A 
NAME - beijing" 
Disconnect From Database 
图 2-1-16 


执行 结果 如 图 2-1-17 所 示 。 


CETTE DatabaseLibrary.Connect To Database Using Custom Params pymysal. database=Wworld, user=root’, password=root, host=localhost’. port=3306 
Documentation: Loads the DB API 2.0 module given “dbapiModuleName’ then uses it to 
start /End /Elapsed: — 20170311 14:17:17.875 /20170311 14:17:17.922 / 00:00:00.047 
[TS] OatataseLibrary Execute Sql String delete from city where NAME=beijing' 
Documentation: Executes the sqiString as SQL commands 


Start /End/ Elapsed: — 20170311 14:17:17,922 /20170311 14:17:17 937 / 00:00:00.015 
[131 $1 Database Library Disconnect From Database 

Documentation: Disconnects from the database. 

Start /End /Elapsed: — 20170311 14:17:17.937 /20170311 14:17:17.937 / 00:00:00.000 


图 2-1-17 
在 SQL 窗口 查询 一 下 有 没有 将 数据 成 功 删 除 。 从 查询 的 结果 看 , 数据 已 经 成 功 地 被 删除 ， 
如 图 2-1-18 所 示 。 


SELECT * FROM city WHERE NAME="beijing’ 
^ Aa 4 d 
m 6 E: @ ë EE 
[Name — |CountryCode [District [Population | 


24.5 ”如何 执行 数据 库 脚本 文件 

在 做 自动 化 测试 时 , 我 们 经 常 需要 构造 数据 或 者 对 库 中 的 数据 进行 初始 化 , 但 是 如 果 我 们 
每 次 都 是 将 要 执行 的 数据 库 脚 本 按 条 写 在 用 例 中 , 那么 将 非常 不 好 维护 , 因此 我 们 需要 直接 执 
行 数据 库 脚 本 文件 。 在 DatabaseLibrary 库 中 ， 可 以 通过 Execute Sql Script 关键 字 来 执行 数据 


库 脚 本 文件 。 
此 处 以 执行 本 地 磁盘 中 的 script.sql 为 例 。 在 script.sql 脚本 中 放 入 需要 执行 的 语句 ， 如 图 


2-1-19 所 示 。 


文件 (有 ”编辑 (E) 格式 (O) BSW) BAH) 
NSERT INTO city(NAME, countrycode, district, population) VALUES( beijing’ ,'ZH' "China, 217100) ; 
INSERT INTO city(NAME, countrycode, district, population) VALUES( shanghai’ ,’ZH',’ China’ , 226100) ; 


2-1-19 


完整 示例 如 图 2-1-20 所 示 。 
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Connect To Database Using Custom Params pymysql 


database-'world',user-'root', password-'root', host-'localhost', port=3306 
Execute Sql Script f:/script.sql 
Disconnect From Database 


Connect To Database Using — pymysql database -'world', user=root’, 
Custom Params password-'root', 
host-'ocalhost', port=3306 
Execute Sql Script f:/script.sql 
Disconnect From Database 
2-1-20 


执行 结果 如 图 2-1-21 所 示 。 


(ISLE) DatabaseLitrary.Connect To Database Using Custom Params pymysql database=Wworld., user=root, password=root' host=localhost’, port=3306 
Documentation: Loads the DB API 2.0 module given `dbapiModuleName` then uses it to 
Start/End/Elapsed: — 2017031122:1025.503/20170311 22:10:25.553 / 00:00:00.050 


DatabaseLibrary Execute Sql Script f /script sql 
Documentation: 


Executes the content of the 'sq/ScriptFileName' as SQL commands. 
Start/ End / Elapsed: — 20170311 22:10:25.553 /20170311 22:10:25.553 / 00:00:00.000 
CEL DatabaseLibrary Disconnect From Database 

Documentation: Disconnects from the database. 

Start/End / Elapsed: 20170311 22:10:25.553 / 20170311 22:10:25.553 / 00:00:00.000 


B 2-1-21 


执行 成 功 后 ， 对 数据 库 进行 查询 ， 会 发 现 脚本 已 经 执行 成 功 、 数 据 已 经 成 功 插入 ， 如 图 
2-1-22 所 示 。 


SELECT * FROM city WHERE NAME='beijing' OR NAME='shanghai' 


226100 


2.1.6 DatabaseLibrary 库 的 其 他 操作 关键 字 
表 2-1-1 中 描述 了 DatabaseLibrary 库 中 其 他 关键 字 的 使 用 方法 。 


表 2-1-1 DatabaseLibrary 库 其 他 关键 字 的 使 用 方法 
关键 字 使 用 描述 


Check If Exists In Database | 检查 数据 库 查询 是 否 有 返回 结果 ， 若 有 返 
失败 ， 示 例 : 


El 


结果 ， 则 用 例 执行 成 功 ， 否 则 执行 


Check If Exists In | SELECT * FROM city WHERE NAME: 
Database 
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(BER) 
关键 字 使 用 描述 
Check If Not Exists 了 | 检查 数据 库 查 询 是 否 有 返回 结果 ， 若 有 返回 结果 ， 则 用 例 执行 失败 ， 否 则 执行 
Database 成 功 ， 示 例 : 
Check If Not Exists In | SELECT * FROM city WHERE NAME=beijing' 
Database and NAME='shanghai’ 


Delete All Rows From Table 


Description 


Row Count 


Row Count Is 0 


Row Count Is Equal To X 


Row Count Is Greater Than 
X 


删除 数据 库 中 某 张 表 中 的 全 部 数据 ， 示 例 : 
[ Delete All Rows From Table 


| World 


描述 数据 库 的 查询 结果 ， 示 例 : 
(à (result) Description SELECT * FROM city WHERE 
NAME =eijing’ or NAME-'shanghai" 
Log Man @ (result 


统计 SQL 查询 返回 的 记录 数 ， 示 例 : 


${rowCount} Row Count SELECT * FROM city WHE 


检查 SQL 查询 返回 的 记录 数 是 否 等 于 某 个 值 ， 示 例 : 
Row Count Is Equal ToX | SELECT * FROM city WHERE 
NAME- beijing or NAME-'shanghai" 


检查 SQL 查询 返回 的 记录 数 是 否 大 于 某 个 值 ， 示 例 : 


Row Count Is Greater | SELECT * FROM city WHERE 
Than X NAME="beijing' or NAME-'shanghai" 


Row Count Is Less Than X | 检查 SQL 查询 返回 的 记录 数 是 否 小 于 某 个 值 ， 示 例 : 
SELECT * FROM city WHERE 
x NAME="beijing' or N. ='shanghai’ 
Table Must Exist 判断 数据 库 中 表 是 否 存 在 ， 示 例 : 


Table Must Exist city 


MongoDBLibrary 库 的 使 用 


MongoDB 是 非常 常用 


的 一 个 非 关 系 型 数据 库 。 Robot Framework 提供 了 对 MongoDB 数据 


库 测试 操作 的 支持 。 我们 可 以 通过 在 浏览 器 中 访问 GitHub 的 网 站 地 址 https://github.com/iPlant 
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CollaborativeOpenSource/Robotframework-MongoDB-Library， 查 看 该 库 的 相关 安装 说 明和 API 
介绍 ， 如 图 2-2-1 所 示 。 


Q | @ =š | nttps//github.com/iPlantCollaborativeOpenSource/Robotframework-MongoDB-Library Ej 
E iPlantCollaborativeOpenSource / Robotframework-MongoDB-Library QWath 18 wWStar 23 YFok 27 
€» Code D Issues 5 Pull requests 3 il Projects 0 lı Insights 
mem Dismiss 
[m Join GitHub today 
GitHub is home to over 28 million developers working together to host [°] 


and review code, manage projects. and build software together. 


A library for interacting with MongoDB from RobotFramework 


(p 62 commits V 1 branch © 0 releases 44. 4 contributors 

perpe] c ves. X22722 

Jerry Schneider added mongodby/ to authenticated host un Latest commit 474e557 on Jul 9 2016 
Ba doc Update Many MongoDB Records’ keyword added 3 years ago 
is s1c/MongoDBLibrary added mongodb:// to authenticated host uri 2 years ago 
i. test PyMongo 3x Support 3 years ago 
E) gitignore * Initial version of how to run acceptance test without compiling the. 6 years ago 
B) LICENSE Replace old licensing with iPlant licensing 6 years ago 
E) MANIFEST Moved repo from being under default qa/robotframework repo 6 years ago 
E) README md Update READ 5 years ago 


图 2-2-1 


安装 完成 后 , 在 使 用 MongoDBLibrary 库 时 , 需要 预先 在 测试 套件 中 导入 该 库 , 如 图 2-2-2 
所 示 。 


Edit | Text Edt | Run 


TestSute13 

Source F:\project\RobotFrameworkTest! RobotFrameworkTest1|TestSute13.txt 
Settings >> 

Import Name / Path Arguments Comment 

Library MongoDBlibrary 


2-2-2 


2.2.1 MongoDB 数据 库 的 连接 和 断 开 
在 MongoDBLibrary 中 通过 Connect To MongoDB 关键 字 来 连接 到 MongoDB 数据 库 ， 该 


29 


关键 字 接 收 [ dbHost=localhost | dbPort=27017 | dbMaxPoolSize=10 | dbNetworkTimeout=None | 
dbDocClass= | dbTZAware=False ] 六 个 参数 。 其 中 ，dbHost 参数 指 的 是 MongoDB 数据 库 的 IP 
地 址 ，dbPort 参数 指 的 是 MongoDB 数据 库 的 端口 号 ， 不 输入 时 默认 为 27017; dbMaxPoolSize 
参数 指 的 是 数据 库 连 接 的 最 大 线程 池 大 小 ， 不 输入 时 默认 大 小 为 10。 

【示例 1】 我 们 连接 到 本 地 电脑 上 一 个 已 经 启动 好 的 MongoDB 数据 库 上 ， 这 里 预先 启动 
了 一 个 3.2 版 本 的 MongoDB 数据 库 ， 如 图 2-2-3 所 示 。 


MongoDB\Ser 25 --logpath| 


B8 .690+8888 F CO L; a iled global initiali ion 
YD: MongoDB\Server f: ould name a file, not a dire 


dbpath "D:\MongoDB\Server\3 - 2 ' 一 logpath| 
\MongoDB EN \log log" 


在 RIDE 中 ， 使 用 Connect To MongoDB 来 连接 刚刚 启动 好 的 数据 库 ， 如 图 2-2-4 所 示 。 
Connect To MongoDB 127.0.0.1 27017 2 
图 2-2-4 
运行 结果 如 图 2-2-5 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase001 


20180825 17:47:32.470 : INFO 


| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'» | False | 
Ending test: RobotFrameworkTestl.TestSutel3.TestCase001 


图 2-2-5 


执行 完成 后 ， 查 看 一 下 MongoDB 服务 端的 日 志 。 从 如 图 2-2-6 所 示 的 MongoDB 服务 端 
的 日 志 可 以 看 到 ， 已 经 成 功 和 MongoDB 数据 库 建立 了 连接 。 


2018-08-25T17:45:30.134+0800 I CONTROL [main] Hotfix KB2731284 or later update 
is not installed, will zero-out data files 

2018-08-25T17:45:30.138+0800 I CONTROL [initandlisten] MongoDB starting 
pid-8964 port-27017 dbpath=D:\MongoDB\Server\3.2\data 64-bit host=yongqing-PC 
2018-08-25T17:45:30.13840800 I CONTROL [initandlisten] targetMinOS: Windows 
Vista/Windows Server 2008 

2018-08-25T17:45:30.13940800 I CONTROL [initandlisten] db version v3.2.4 
2018-08-25T17:45:30.139+0800 I CONTROL [initandlisten] git version: 
e2ee9ffcf9f5a94fad76802e28cc978718bb7a30 

2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] allocator: tcmalloc 
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2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] modules: none 
2018-08-25T17:45:30.140+0800 I CONTROL [initandlisten] build environment: 
2018-08-25T17:45:30.161+0800 I CONTROL [initandlisten] distarch: x86_64 
2018-08-25T17:45:30.162+0800 I CONTROL [initandlisten] target arch: x86 64 
2018-08-25T17:45:30.162+0800 I CONTROL [initandlisten] options: { storage: 

{ dbPath: "D:\MongoDB\Server\3.2\data" }, systemLog: ( destination: "file", path: 
"D: \MongoDB\Server\3.2\logs\log.log" } 
2018-08-25T17:45:30.164+0800 I STORAGE initandlisten] wiredtiger_open config: 
create, cache_size=4G, session_max=20000, eviction=(threads_max=4) , config_base=f 
alse, statistics=(fast) , log=(enabled=true, archive=true, path=journal, compressor 
=snappy) , file_manager=(close_ idle time=100000) , checkpoint=(wait=60, log size=2 
GB) ,statistics_log=(wait=0), 
2018-08-25T17:45:31.202+0800 I FTDC initandlisten] Initializing full-time 
diagnostic data capture with directory 
'D:/MongoDB/Server/3.2/data/diagnostic.data"' 
2018-08-25T17:45:31.202+0800 I NETWORK [HostnameCanonicalizationWorker] 
Starting hostname canonicalization worker 
2018-08-25T17:45:31.359+0800 I NETWORK [initandlisten] waiting for connections 
on port 27017 

2018-08-25T17:46:53.205+0800 I NETWORK [initandlisten] connection accepted from 
127.0.0.1:2621 #1 (1 connection now open) 

2018-08-25T17:46:53.730+0800 I NETWORK  [connl] end connection 127.0.0.1:2621 (0 
connections now open) 

2018-08-25T17:47:32.471+0800 I NETWORK [initandlisten] connection accepted from 
127.0.0.1:2650 #2 (1 connection now open) 

2018-08-25T17:47:33.031«0800 I NETWORK [conn2] end connection 127.0.0.1:2650 (0 
connections now open) 


2-2-6 


在 MongoDBLibrary 中 通过 Disconnect From Mongodb 关键 字 来 断 开 已 经 建立 的 
MongoDB 数据 库 连 接 。 
【示例 23 通 过 Disconnect From Mongodb 关键 字 断 开 MongoDB 的 数据 库 连接 , 如 图 2-2-7 
所 示 。 


[Connect To MongoDB 


27017 


运行 结果 如 图 2-2-8 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase001 

20180825 17:57:04.680 : INFO 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'> | False | 
20180825 17:57:04.684 : INFO : | Disconnect From MongoDB | 

Ending test: RobotFrameworkTestl.TestSutel3.TestCase001 


2-2-8 
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从 MongoDB 的 日 志 可 以 看 到 ， 在 执行 Disconnect From Mongodb 关键 字 操 作 后 ， 数 据 库 
服务 端 日 志 中 已 经 显示 数据 库 连 接 终止。 


[conn3] end connection 127.0.0.1:2945 (0 connections now open) 


2.2.2 Get Mongodb Databases 和 Get Mongodb Collections 


在 MongoDBLibrary 中 通过 Get Mongodb Databases 关键 字 来 获取 当前 MongoDB 下 所 有 在 
的 数据 库 。 
【示例 1] 我 们 通过 Get Mongodb Databases 关键 字 来 获取 上 面 启动 的 MongoDB 下 的 所 有 
数据 库 ， 如 图 2-2-9 所 示 。 


Connect To MongoDB 127.0.0.1 27017 2 
@(DBs) Get Mongodb 
Databases 
Log Many @{DBs} 
Disconnect From Mongodb 
图 2-2-9 


运行 结果 如 图 2-2-10 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase003 

20180825 21:55:34.867 : INFO : 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'> | False | 


20180825 21:55:34.873 : INFO : | @{allDBs} | Get Mongodb Databases | 
20180825 21:55:34.873 : INFO : @{DBs} = [ local ] 

20180825 21:55:34.875 : INFO : local 

20180825 21:55:34.877 : INFO : | Disconnect From MongoDB | 

Ending test: RobotFrameworkTestl.TestSutel3.TestCase003 


图 2-2-10 


从 运行 结果 可 以 看 到 只 获取 到 了 一 个 名 叫 local 的 数据 库 。 我 们 通过 客户 端 连接 到 
MongoDB 服务 端 ， 然 后 执行 show databases 命令 ， 可 以 看 到 得 到 的 结果 和 我 们 通过 Get 
Mongodb Databases 关键 字 来 获取 到 的 数据 库 信 息 是 一 致 的 ， 如 图 2-2-11 所 示 。 


nongo 127.00.1:27017 一 -一 | 


t Windows [RÆ 6.1.26011 
<c> 2009 Microsoft Corporation. f 


\yongaing>d: 


88 I CONTROL [main] Hotfix KB2731284 or later update 
ut data files 


7/test 


图 22-11 
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通过 Get Mongodb Collections 关键 字 可 以 获取 到 指定 MongoDB 数据 库 下 的 所 有 
Collection， 该 关键 字 接 收 [ dbName ] 一 个 参数 。 
【示例 2 我 们 通过 Get Mongodb Collections 关键 字 来 获取 到 local 库 下 的 所 有 Collection, 
如 图 2-2-12 所 示 。 


[Connect To MongoDB 127.0.0.1 27017 J 
(a (DBs) Get Mongodb Databases 

|Log Many @{DBs} 

(a (eliCollections) Get Mongodb Collections local 

Log Many @aliCollections} 


图 2-2-12 


结果 如 图 2-2-13 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase002 

20180825 22:03:31.189 : INFO : 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'> | False | 


20180825 22:03:31.197 : INFO : | @{allDBs} | Get Mongodb Databases | 
20180825 22:03:31.198 : INFO : @{DBs} = [ local ] 

20180825 22:03:31.200 : INFO : local 

20180825 š 31.205 : INFO: | @{allCollections} | Get MongoDB Collections | 
local | 

20180825 22:03:31.206 : INFO : @(allCollections) = [ startup_log ] 

20180825 22:03:31.208 : INFO : startup_log 

20180825 22:03:31.210 : INFO : | Disconnect From MongoDB | 


Ending test: RobotFrameworkTestl.TestSutel3.TestCase002 


图 2-2-13 


从 运行 结果 可 以 看 到 ,获取 到 的 local 库 下 的 Collection 名 叫 startup log， 然 后 我 们 通过 客 
户 端 连 接 到 服务 端 ， 通 过 客户 端 show collections 命令 来 获取 Collection。 我 们 可 以 看 到 获取 到 
的 Collection 是 完全 一 致 的 ， 如 图 2-2-14 所 示 。 


2wbin?mongo 1. 
10888 1 CONTROL 
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2.2.3 Save Mongodb Records 


Save MongoDB Records 关键 字 用 来 向 指定 的 Collection 中 保存 插入 的 记录 , 接收 [ dbName 
| dbCollName | recordJSON ] 三 个 参数 。 
【示例 】 我 们 向 startup log 这 个 Collection 中 插入 一 条 记录 ， 如 图 2-2-15 所 示 。 


Connect To MongoDB 127.0.0.1 27017 2 
Save Mongodb Records local startup_log {"book":"RobotFramework"} 


Disconnect From Mongodb 


图 2-2-15 


运行 结果 如 图 2-2-16 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase004 

20180825 22:16:34.333 : INFO : 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'» | False | 
20180825 22:16:34.344 : INFO : | ${allResults} | Save MongoDB Records | local 
| startup log | [u'book': u'RobotFramework', ' id': 
ObjectId('5b8164c2685b132ec4739503')]) | 

20180825 22:16:34.347 : INFO : | Disconnect From MongoDB | 

Ending test: RobotFrameworkTestl.TestSutel3.TestCase004 


图 2-2-16 


执行 完成 后 ， 我 们 通过 MongoDB 客户 端 连接 到 服务 端 ， 执 行 db.startup_log.findO 命 令 来 
查看 startup_log 这 个 Collection 下 的 记录 。 可 以 看 到 {"book":"RobotFramework"} 这 条 数据 
已 经 成 功 插入 MongoDB 中 ， 如 图 2-2-17 所 示 。 


记录 


uni 管理 员 : C:\Windows\system32\cmd.exe -mongo 127.0.0.1:27017 


_log .f ind<>; 
y-PC-1535198 


MongoDB. 
lest ination" a 了 longoDB 
pid" : Number 
9ffcf9f5a94fad76892， 


ldEnvi 
ft CR) C. 
nologo /EHsc 


444880 /wd4267 /wd4244 B68 /wd435 
: ‘Zc > inline” 


| arch" 
bsono 
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数据 库 的 操作 


2.24 Retrieve All Mongodb Records 


Retrieve All Mongodb Records 关键 字 用 来 获取 指定 Collection 下 的 所 有 数据 记录 ， 接 收 
[ dbName | dbColIName | returnDocuments=False ] 三 个 参数 。 
【示例 】 我 们 通过 Retrieve All Mongodb Records 关键 字 来 获取 startup log 下 的 数据 记录 ， 
如 图 2-2-18 所 示 。 


Connect To MongoDB 127.0.0.1 
Retrieve All Mongodb 
Records 


$allResults} 


图 2-2-18 


运行 结果 如 图 2-2-19 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase005 

20180825 22:38:05.197 : INFO : 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'> | False | 
20180825 22:38:05.213 : INFO : ${allResults} = [(u'hostname': u'yongqing-PC', 
u'pid': 8964L, u'startTimeLocal': u'Sat Aug 25 17:45:31.203', u'cmdLine': 
[u'storage': {u'dbPath': u'D:\\MongoDB\\Server\\3.2\\data'}, u'systemLog': 
{u'path': u'D:\\Mong... 

20180825 22:38:05.215 : INFO : [{u'hostname': u'yongqing-PC', u'pid': 8964L, 
u'startTimeLocal': u'Sat Aug 25 17:45:31.203', u'cmdLine': (u'storage': 
{u'dbPath': u'D:\\MongoDB\\Server\\3.2\\data'}, u'systemLog': {u'path': 
u'D:\\MongoDB\\Server\\3.2\\logs\\log.log', u'destination': u'file'}}, 
u'startTime': datetime.datetime(2018, 8, 25, 9, 45, 31), u' id': 
u'yongging-PC-1535190331203', u'buildinfo': {u'storageEngines': [u'devnull', 
u'ephemeralForTest', u'mmapvl', u'wiredTiger'], u'maxBsonObjectSize': 16777216, 
u'bits': 64, u'sysInfo': u'deprecated', u'modules': [], u'openssl': (u'compiled': 
u'disabled', u'running': u'disabled'), u'javascriptEngine': u'mozjs', 
u'version': u'3.2.4', u'gitVersion': 
u'e2ee9ffcf9f5a94fad76802e28cc978718bb7a30', u'versionArray': [3, 2, 4, 0], 
u'debug': False, u'buildEnvironment': {u'cxxflags': u'/TP', u'cc': u'cl: 
Microsoft (R) C/C++ Optimizing Compiler Version 18.00.31101 for x64', 
u'linkflags': u'/nologo /DEBUG /INCREMENTAL:NO /LARGEADDRESSAWARE /OPT:REF', 
u'distarch': u'x86 64', u'cxx': u'cl: Microsoft (R) C/C++ Optimizing Compiler 
Version 18.00.31101 for x64', u'ccflags': u'/nologo /EHsc /W3 /wd4355 /wd4800 
/wd4267 /wd4244 /wd4290 /wd4068 /wd4351 /we4013 /we4099 /we4930 /2z7 
/errorReport:none /MT /02 /Oy- /Gw /Gy /Zc:inline', u'target arch': u'x86 64', 
u'distmod': u'', u'target os': u'windows'}, u'targetMinOS': u'Windows 
Vista/Windows Server 2008', u'allocator': u'tcmalloc'}}, (u' id': 

ObjectId ('5b8164c2685b132ec4739503"'), u'book': u'RobotFramework']] 

20180825 22:38:05.217 : INFO : | Disconnect From MongoDB | 

Ending test: RobotFrameworkTestl.TestSutel3.TestCase005 


图 2-2-19 
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如 图 2-2-20 所 示 , 运行 结果 与 我 们 在 客户 端 通过 db.startup log.find0 命 令 行 获取 到 的 结果 
是 一 致 的 。 


管理 员 : C:\Windows\system32\cmd.exe - mongo 127.0.0.1:27017 m c |i 


Microsoft 
-31101 for ^ ags nologo 
wd4290 /wd4068 /wd4351 

Gu /Gy 72 


WARE ¿OPT 
“windows” >, . "debug 


85b132ec4739503"5, "book" : "I 


2.2.5 Update Many Mongodb Records 


Update Many Mongodb Records 关键 字 用 来 更 新 Collection 中 的 数据 记录 ， 接 收 [ dbName | 
dbCollName | queryJSON | updateJSON | upsert-False ] 五 个 参数 。 

【示例 】 我 们 更 新 上 面 示例 中 插入 的 {"book":"RobotFramework"} 记 录 为 {"book":"robotFramework"}， 
即将 RobotFramework 变 为 robotFramework， 如 图 2-2-21 所 示 。 


Connect To MongoDB 127.0.0.1 27017 2 
${newdson’ Set Variable — ("$set": 
{"book'':"robotFramework"} 
Update Many Mongodb Records local startup log {"book’:"RobotFramework"} s(new)son; 


Disconnect From Mongodb 


运行 结果 如 图 2-2-22 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase006 

20180825 23:05:53.692 : INFO : 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'» | False | 
20180825 23:05:53.700 : INFO : ${newJson} = ("$set": {"book": "robotFramework"} } 
20180825 23:05:53.708 : INFO : 

Matched: 1 documents 

| $(allResults) | Update Many MongoDB Records | local | startup log | {u'book': 
u'RobotFramework') | {u'$set': {u'book': u'robotFramework'}} | 

20180825 23:05:53.710 : INFO : | Disconnect From MongoDB | 


Ending test: RobotFrameworkTestl.TestSutel3.TestCase006 


图 2-222 
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更 新 完成 后 ， 通 过 客户 端的 db.startup_ log.find0 命 令 来 进行 重新 查询 ， 如 图 2-2-23 所 示 。 
从 查询 的 结果 可 以 看 到 指定 的 记录 已 经 更 新 完成 了 。 


findows\system32\cmd.exe - mongo 127.0.0.1:27017 


: 64, “debug” 
E “devnull”, "ephene 
"uiredTiger" 1 > > 
Object 1d¢"5h8164c2685b132ec 4739583", : “Robot Framewo 
ab. startup 
ngqing-P( 
" Aug 25 1 
"dbPath" : "D:\\MongoDB\\Server data" 
"file", "path" : \MongoDB\\Server\\3.2\ 
: NumberLong(8964>, "buildinfo" : 
f9f5a94fad768B2e28cc978718D "targetMinOS" 
"nodul A ° "tcnalloc", 
sysInfo" : precated", "versionfürray" : [ 3, 2 
"or € "running" : "disabled", "compiled" : "disabled" >, "buildEnvi 
"distmod" : "", "distarch" E Microsoft ¢R> C 
nologo / 
/ud42980 e we4999 / 
Oy- /Gu d 


-31101 for ATP" 
"/nologo /DEBUG /INCREME :NO /LRRGERDDRESS E 70 E arget 
x86_64", “target_os” : "wi i "E : E. 
21 
dTiger" ] > " 
ect 1d¢"5b8164c2685b132ec 4739503") 


2.2.6 Remove Mongodb Records 


Remove Mongodb Records 关键 字 用 来 删除 指定 Collection 中 的 数据 记录 ， 接 收 [ dbName | 
dbCollName | recordJSON ] 三 个 参数 。 

【示例 】 我 们 重新 创建 一 个 capped 属性 为 false 的 Collection， 因 为 之 前 的 Collection 的 
性 为 tue， 会 导致 数据 记录 无 法 被 删除 。 在 客户 端 创建 一 个 Collection 的 命令 为 
db.createCollection("RobotFramework", {capped : false})， 如 图 2-2-24 所 示 ， 新 的 名 叫 
RobotFramework 的 Collection 创建 完成 。 


capped J| 


En SEA: C:\Windows\system32\emd.exe - mongo 12700127017 | F lole mmm] 


> db.createCollection<"RobotFramework", {capped : false>> a 
E eh? 2-2) 

> show collections 

Robot Framework 

startup_log 


创建 完成 后 ， 通 过 客户 
然后 我 们 使 用 Remove Mongodb Records 关键 字 来 删除 {"book 
如 图 2-2-26 所 示 。 


的 db.Robot Framework find0 命 令 进行 查询 ， 如 图 2-2-25 所 示 。 


"TobotFramework"} 这 条 记录 ， 
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use local 
itched to db local 
> db. Robot Framework.find<> 
d" : ObjectId("5582802ee685b130624a2bc4d"5, "book" : “RobotFramework" > 


Connect To MongoDB 127.0.0.1 27017 2 
${Json} Set Variable {"book":"RobotFramework"} 
Remove Mongodb Records local RobotFramework ${Json} 


Disconnect From Mongodb 


图 2-2-26 
运行 结果 如 图 2-2-27 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel3.TestCase007 

20180826 09:40:05.945 : INFO 

| Connect To MondoDB | dbHost | dbPort | dbMaxPoolSize | dbNetworktimeout | 
dbDocClass | dbTZAware | 

| Connect To MondoDB | 127.0.0.1 | 27017 | 2 | None | «type 'dict'» | False | 
20180826 09:40:05.947 : INFO : $(Json) = {"book" 
20180826 09:40:05.970 : INFO: | ${allResults} | Remove MongoDB Records | local 


RobotFramework") 


| RobotFramework | {u'book': u'RobotFramework"} | 
20180826 09:40:05.972 : INFO : | Disconnect From MongoDB | 


Ending test: RobotFrameworkTestl.TestSutel3.TestCase007 


图 2-2-27 


执行 完成 后 ， 在 客户 端 执 行 db.RobotFramework.find0 进 行 查询 ， 如 图 2-2-28 Aras, ME 
询 的 结果 可 以 看 到 {"book":"robotFramework"} 这 条 记录 已 经 被 删除 。 


EI 管理 员 : C:\Windows\system32\cmd.exe - mongo 127.0.0.1:27017 — Gm] 


“RobotFramework" > 


685b130624:; c4d"), "book" = 


> db. Robot Franewor! 
> db.RobotFramework.f ind» 
> 


图 2-2-28 


2.277 MongoDBLibrary 库 的 其 他 关键 字 
表 2-2-1 中 列 出 了 MongoDBLibrary 库 中 其 他 关键 字 的 使 用 示例 。 
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表 2-2-1 MongoDBLibrary 库 中 其 他 关键 字 


关键 字 使 用 描述 

Drop Mongodb | 该 关键 字 用 来 删除 指定 的 MongoDB 数据 库 ， 接 收 [dbDeIName ] 一 个 参数 ， 示 例 : 
Database Drop Mongodb Database local 

Drop Mongodb | 该 关键 字 用 来 删除 指定 的 Collection, tr dbName | dbCollName ] 两 个 参数 ， 示 例 : 
Collection Drop Mongodb Collection | local RobotFramework 


该 关键 字 用 来 获取 指定 Collection 下 的 数据 记录 总 数 ， 接 收 [ dbName | dbCollName ] 两 个 参 
Get Mongodb ”| 数 ， 示 例 : 
Collection Count ||_${counts} 


local | RobotFramework 
${counts} | 


该 关键 字 用 来 获取 并 且 更 新 指定 的 数据 记录 ， 接 收 [ dbName | dbCollName | queryJSON 
updateJSON | returnBeforeDocument=False ] 五 个 参数 ， 示 例 : 


Get Mongodb Collection Count 


log 


${queryJson} Set Variable {"book":"RobotFra 
mework" 
Retrieve And E 
${newJson} Set Variable {"Sset": 
Update One 
{"book":"robotFra 
Mongodb i 
mework 
Record 
Retrieve And RobotFramework ${queryJson} | ${newJson} 
Update One 
Mongodb 
Record 
该 关键 字 用 来 从 Collection 中 根据 指定 的 字段 查询 出 对 应 的 满足 要 求 的 数据 记录 ， 接 收 
[ dbName | dbColIName | recordJSON | fields | return__id=True | TetumDocuments=False ] 六 个 
参数 ， 示 例 : 
Retrieve $ {result} Retrieve 
Mongodb 
Records With 
Desired Fields 


log $ {result} 


该 关键 字 用 来 从 Collection 中 查询 出 根据 指定 ISON 匹配 到 的 数据 记录 ， 接 收 
[dbName | dbColIName | recordJSON | returnDocuments=False ] 四 个 参数 ， 示 例 : 


Retrieve Some 


$ {result} Retrieve Some | local RobotFramework | {"book":"robot 
Mongodb 
Mongodb Framework"} 
Records 
Records 
log $ {result} 
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第 3 章 
HTTP 接 口 自动 化 测试 


HTTP 接口 自动 化 测试 是 常见 的 一 种 自动 化 测试 需求 和 需要 。 在 Robot Framework 中 ， 
RequestsLibrary、HttpLibrary.HTTP、REST 等 库 都 可 以 用 来 做 HTTP 接口 方面 的 自动 化 测试 。 


HttpLibrary.HTTP 库 的 使 用 


通过 访问 GitHub 地 址 https://github.com/peritus/robotframework-httplibrary/#readme 可 以 下 
载 和 安装 HttpLibrary.HTTP 库 ， 如 图 3-1-1 所 示 。 


Signin Sign up 


图 3-1-1 


安装 方式 也 可 以 通过 pip install --upgrade robotframework-httplibrary 来 进行 在 线 安装 。 安 
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装 完成 后 ， 在 使 用 时 需要 在 RIDE 中 导入 HttpLibrary HTTP 库 ， 如 图 3-1-2 所 示 。 


“Edit | Text Edit | Run 


TestSuite4 

Source F:VprojectiRobotFrameworkTesti 'RobotFrameworkTest1 \ TestSuttes.txt 
Settings >> 

Import Name / Path Arguments Comment 

Library Httplibrary.HTTP 


3-1-2 


3.1.1 Create Http Context 


要 想 使 用 HttpLibrary，Create Http Context 关键 字 是 必 不 可 少 的 ， 其 作用 相当 于 创建 了 一 
A HTTP 调用 的 环境 。 

Create Http Context 关键 字 需 要 接收 两 个 参数 : host 和 scheme. host 参数 等 同 于 HTTP 协 
iP Header CAM) 中 的 Host〈 指 定 请 求 的 服务 器 的 域名 和 端口 号 ) o scheme 参数 如 果 没 有 
传 入 ， 就 默认 为 htp， 也 可 以 传 入 https〈 调 用 时 使 用 HTTPS 协议 ) 。 

【示例 1】scheme=http， 并 且 host 参数 指定 了 域名 和 端口 ， 如 图 3-1-3 所 示 。 


Create Http Context host-www.baidu.com:80 scheme=http 


Create Http Context host=www.baidu.com:80 scheme=http 


FA 3-1-3 
执行 结果 如 图 3-1-4 所 示 。 


HttpLibraryHTIP.Create Http Context host=www.baidu.com:80, scheme=http 
Documentation: Sets the HTTP host to use for future requests. You must call this 
Start / End / Elapsed: 20170404 23:24:03.093 / 20170404 23:24:03.093 / 00:00:00.000 


23:24:03. 093 INFO Host for next HTTP request set to ’www. baidu. com:80 
23:24:03. 093 INFO Scheme for next HTTP request set to ‘http’ 


图 3-1-4 


【示例 2] scheme-https, JH. host 只 指定 了 域名 ， 没 有 指定 端口 号 ， 直 接 使 用 HTTPS 
协议 进行 请 求 调用 ， 如 图 3-1-5 所 示 。 


| Create Http Context host-www.baidu.com scheme-https | 


Create Http Context host=www.baidu.com sdheme=https 


图 3-1-5 
执行 结果 如 图 3-1-6 所 示 。 
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= [3331810 htpubrayHTIP.Create Http Context host=www.baidu.com, scheme=https 


Documentation: Sets the HTTP host to use for future requests. You must call this 
Start / End / Elapsed: 20170404 23:22:07.393 / 20170404 23:22:07.393 / 00:00:00.000 
23:22:07. 393 INFO Host for next HTTP request set to ‘www. baidu. com’ 
23:22:07. 393 INFO Scheme for next HTTP request set to ‘https’ 
图 3-1-6 
3.1.2 Get 


在 使 用 Create Http Context 关键 字 创 建 了 HTTP 的 调用 环境 后 ， 就 可 以 使 用 Get 关键 字 来 
发 送 一 个 HTTP 协议 中 常用 的 get 请 求 了 。 
Get 关键 字 只 接收 一 个 wl 参数 。 该 关键 字 的 API 中 对 url 的 原始 描述 是 : "url is the URL 
relative to the server root. 
【示例 1】 使 用 get 请 求 访问 百度 主页 ， 如 图 3-1-7 所 示 。 


Create Http Context host=www.baidu.com:80 scheme=http 


GET / 
Create Http Context host=www.baidu.com:80 scheme=http 
GET / 
3-1-7 


执行 结果 如 图 3-1-8 所 示 。 


- HttpLibraryHTTP .Create Http Context host=www.baidu.com:80, scheme-http 
Documentation: Sets the HTTP host to use for future requests. You must call this 


Start / End / Elapsed: 20170405 23:24:50.756 / 20170405 23:24:50.760 / 00:00:00.004 
23:24:50. 759 INFO Host for next HTTP request set to ‘www. baidu. com:80 


23:24:50. 759 INFO Scheme for next HITP request set to ‘http’ 


= HttpLibraryHTTP.GET / 
Documentation: Issues a HTTP GET request. 
Start / End / Elapsed: 20170405 23:24:50.761 / 20170405 23:24:54.176 / 00:00:03.415 


图 3-1-8 


【示例 2】 使 用 get 请 求 访问 Robot Framework 主页 下 的 examples, WA 3-1-9 所 示 。 


Create Http Context robotframework.org scheme=http 
GET /#examples 


Create Http Context robotframework.org scheme-http 
GET /#examples 
1 
3-1-9 


执行 结果 如 图 3-1-10 所 示 。 
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= HttpLibraryHTIP.Create Http Context robotframework.org, scheme=http 
Documentation: Sets the HTTP host to use for future requests. You must call this 
Start / End | Elapsed: 20170405 23:38:15.781 / 20170405 23:38:15.781 / 00:00:00.000 
23:38:15. T81 INFO Host for next HTTP request set to "robotfremework org 
23:38:15. 781 INFO Scheme for next HTTP request set to "http 
- HttpLibraryHTTP.GET /#examples 
Documentation: Issues a HTTP GET request. 
Start / End / Elapsed: 20170405 23:38:15.781 / 20170405 23:38:19.047 / 00:00:03.266 
- S(body) = HttpLibraryHTTP.Get Response Body 
Documentation: Getthe response body. 
Start / End / Elapsed: 20170405 23:38:19.057 / 20170405 23:38:19.107 / 00:00:00.050 


图 3-1-10 


【示例 3】 使 用 get 请 求 访问 一 个 带 有 传 入 参数 的 示例 ， 如 图 3-1-11 所 示 。 


Create Http Context sp0.baidu.com scheme=https 
GET/5alFazu8AA54nxGko9WTAnF6hhy/su?wd-htt&json-l&p-3&sid-22584 1441 21089 221 
76 20928&req-2&csor-0&pwd-ht&cb-jQuery110201988529936624046 1492182668411& -1 
492182668416 

$ (body) Get Response Body 


图 3-1-11 
执行 结果 如 图 3-1-12 所 示 。 


= Tapina ATIP Croate Hip Comet spò 
Documentation: 


[rZ 


Start End Elapsed: z 
21450000 INFO Kest for aet MTTP cert set 
211950000 INFO. Sebene for next MIT receest set te to 

Fe 00-00-00 8s 

son=1&p-36sid-22564_1441_21099_22176_209298reqr28csorr08pwd-htacbriQueryr110201996528636624045_14821626684118 «1452102602415 
Documentaton: Issues HTTP GET 
Start/End | Elapeed: 20170414 23:12:50 027 /2917041423:1259.964 /000000.837 

7 [III] 503) = Hist tran.HT7P. Get Response Body 00.00 00.01 

Documentation: Ge ne response booy 


Start/End | Elapsed: — 20170414231350 864 / 20170414 23 130.874 /00 0000 010. 
23:13:50.07¢ INFO) Site «€, eL 02666411 (7g “ku”, "y" Falae, “ba” "^, caor": “0%, "stata 0, "e E La "hg V, “e: Iu, tts CSS ge VU “aa 0 
1T 


XD T 
= CELE euin. Loo sbodh oorun 
Documentation: Logs the given message with the given level 
Start/End/ Elapsed: 20170414 234350874120170414231330.68410C0D00 10 
zrissbsw INEO 


3-1-12 
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3.1.8 Get Response Body 
Get Response Body 关键 字 在 上 面 已 经 用 到 了 ， 服 务 器 端 在 完成 处 理发 出 HTTP 请 求 后 会 


给 出 对 应 的 响应 结果 ， 这 时 Get Response Body 关键 字 就 可 以 用 来 获取 响应 结果 中 的 


E 体 内 容 


的 。 一 般 在 get 请 求 或 者 post 请 求 发 出 后 使 用 该 关键 字 。 
【示例 】 访 问 苏宁 易 购 网 站 上 的 HTTP 推荐 接口 ， 使 用 Get Response Body 关键 字 获 取 返 
回 的 内 容 ， 如 图 3-1-13 所 示 。 


Create Http Context tuijian.suning.com scheme=http 
GET 


/recommend-portal/recommendv2/biz.jsonp?callback-showFinal&parameter-$E7$ 
AC*945E8SAESBOSE6S9CSAC&sceneIds-2-l1&count-5&cityId-9173&price-&brandCode- 

$ (body) Get Response Body 

log $ {body} 


[Create Http Context tuian.suning.com scheme=http 


3-1-13 


- CELI sto) = HiLirayHTIP.Got Rosponeo Body ow 


= CELE Lop tod] 


23:41 19.418 
manas 


HepLbraryliTTP. Create Htip Context lunar. sunimg com, schemerhttp [T 
Documentation: 


Stort/ End /Elopsed: 


INFO 
INFO 


Documentation: 
Stort /End /Elopsed: 


Documontation: 
Start/ End / Elapsed: 


23:41:13.409 


INFO 


23:41:13.400 


INFO 


QELE entree GET econon pera econrend iz porpre darh=shouF ralt Forarmetor NETRACN SEES AP BUSES GOSACA cd 
z S 


ouni “Skcityld=0 17 3pnce=BbrancCode= 


Sets ne HTTP host o usa for fure requests. You must cali mis 
2orT0414 2341 15415 20170414234) 12417 1000000902 
Hort for et HITT negent set 


Shane for naet HTTP reguart cot te ht 


Issues a HTTP GET request 
20170414 2341 13.419 2017041423 41 1343410000 00.085 


Gel re response body 
20170414 2341 13 484 (20170414 23 
[UE rn 

— 4" "rage 


Loos the given message with the given level 
2017041423 41 12487 1201704142341 
itid (C Dua asellus", “s Ta" “9179, “aks 
rr Teal Wa ses BASIS ra stel sia TIS wt eT SERNA 

watch esi cit eire? r ae iQ eV Nene ea bes T-T800V 160 


ee 9689.00", “refr: 


"3089 00" "atr" “215020 


————— 
wig CE bOI Vsstrs 15-3559-268 


7, "price" "3088 00", "refPri ee” “3054 00" 


si nab ye Wat2 af bc\ zcore MATS 46 1206 
0, "release": "3571. OD", “eatGroapld” “ES02001 


3.1.4 Get Response Status 


Get Response Status 关键 字 用 来 获取 HTTP 请 求 返回 的 HTTP 状态 码 。 
【示例 】 访 问 苏宁 易 购 网 站 上 的 HTTP 推荐 接口 , 使 用 Get Response Status 关键 字 来 获取 
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返回 的 HITP 状态 码 ， 如 图 3-1-15 所 示 。 


Create Http Context tuijian.suning.com scheme=http 
GET 


/recommend-portal/recommendv2/biz.jsonp?callback-showFinal&parameter-$E7$ 
AC&945E8SAESBOSE6S9CSAC&sceneIds-2-1&count-5&cityId-9173&price-&brandCode- 
$ (body) Get Response Status 


log $ {body} 

Create Http Context tujan.suning.com scheme -http E 
GET | "s 
(body) Get Response Status | | 
log S(body) 


图 3-1-15 
执行 结果 如 图 3-1-16 所 示 。 


- HttpLibxaryHTTP. Create Http Context tuijian suning com. scheme=http 


Documentation: Sets the HTTP hostto use for future requests. You must call this 
Start/End/Elapsed: — 2017041500:11:12915/20170415 00:11:12.916 / 00:00:00.001 
00:11:12.916 — INFO Host for next HTTP request set to ‘ tuijian suning. com 
00:11.12.916 INFO Scheme for next MITE request set to "http 


- HpLEraryH TTP.GET /recommend-portal/recommendvZ/biz jsonp?callback-showFinal& parameter="%E7%AC%S4%ES%AE %BO%ES%SC%ACE scenelds-2- 
cityld-9173&price-& brandCode-- 


Documentation: Issues a HTTP GET request 
Start / End / Elapsed: 20170415 00:11:12.917 / 20170415 00:11:13.007 / 00:00:00.090 
= S(body) = HtpLbraryHTIP.Get Response Status 
Documentation: Returns the response status line (e.g. "200 OK" or “404 Not found") 
Start / End / Elapsed: 20170415 00:11:13.007 / 20170415 00:11:13.007 / 00:00:00 000 
00:11:13. 007 INFO  $bedy] = 200 OK 
= CSTE puan Log $(body) 
Documentation: Logs the given massage with the given level. 
‘Start / End / Elapsed: 20170415 00:11:13.007 / 20170415 00:11:13.007 / 00:00:00.000 
00:11:13.007 — INFO 200 ok 
FA 3-1-16 


从 获取 到 的 结果 看 ， 我 们 获取 到 的 状态 码 为 200 OK. 


3.1.5 Get Response Header 


Get Response Header 关键 字 用 来 获取 HTTP 请 求 返回 的 HTTP 响应 头 部 数据 。 常 见 的 
Response Header 如 表 3-1-1 所 示 。 


表 3-1-1 常见 的 Response Header 


Accept-Ranges 该 字段 表示 服务 器 是 否 支持 指定 范围 内 的 请 求 及 Accept-Ranges: bytes 
哪 种 类 型 的 分 段 请 求 


Age 由 原始 服务 器 到 代理 缓存 形成 过 程 中 的 估算 时 间 | Age: 12 


(以 秒 来 计算 ， 非 负数 ) 


对 某 种 网 络 资源 允许 的 有 效 的 请 求 行为 类 型 ， 若 不 | Allow: GET, HEAD, POST 
允许 则 返回 http 状态 码 为 405 
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( 续 表 ) 
Header 解释 示例 
Cache-Control 标明 所 有 的 缓存 机 制 是 否 可 以 缓存 及 是 哪 种 类 型 | Cache-Control: no-cache 
的 缓存 
Content-Encoding | 服务 器 支持 的 返回 内 容 的 压缩 编码 类 型 Content-Encoding: gzip 
Content-Language | 响应 体 的 语言 类 型 Content-Language: en.zh 
Content-Length 响应 体 的 长 度 Content-Length: 500 
Content-Location | 请 求 资源 可 蔡 代 的 备用 的 其 他 请 求 地 址 Content-Location: /home.htm 
Content-MD5 返回 资源 的 MD5 加 密 校 验 值 Content-MDS: 
H3hlY1sgSWA40RWcypXR9IK— 


Content-Range 用 于 响应 头 ， 指 定 整个 实体 中 一 部 分 的 插入 位 置 。| Content-Range: bytes 
它 也 指示 了 整个 实体 的 长 度 ,在 服务 器 向 客户 返回 | 21010-47021/47022 
一 个 部 分 响应 。 它 必须 描述 响应 覆盖 的 范围 和 整个 
实体 的 长 度 ， 一 般 格式 为 : 
Content-Range: bytes (unit first byte pos) - [last byte 
pos]/[entity legth] 


返回 内 容 的 MIME 类 型 Content-Type:text/html;charset-utf-8 
Date 


原始 服务 器 消息 发 出 的 时 间 Date: Tue, 19 Nov 2014 20:12:31 
GMT 


ETag 请 求 变量 的 实体 标签 的 当前 值 ETag: "737060cd8c284d8af7ad308 
2£209582d" 


响应 过 期 的 日 期 和 时 间 Expires: Thu, 03 Dec 2014 19:00:00 
GMT 


Last-Modified 请 求 资 源 的 最 后 修改 时 间 Last-Modified: Tue, 17 Nov 2015 
13:25:16 GMT 


用 来 重 定向 接收 方 到 非 请 求 URL 的 位 置 来 完成 请 | Location: http://www.cnblogs.com/ 
求 或 标识 新 的 资源 ， 通 俗 地 说 就 是 Web 服务 器 告 | laoqing/p/8542487.html 

诉 浏览 器 。 试 图 访问 的 对 象 已 经 被 移 到 别 的 位 置 ， 

到 该 头 部 指定 的 位 置 去 取 


一 个 在 HTTP/LO 中 规定 的 通用 首部 Pragma: | Pragma: no-cache 
no-cache 兼容 HTTP 1.0， 包 括 实现 特定 的 指令 ， 可 
应 用 到 响应 链 上 的 任何 接收 方 


Proxy-Authenticate | 该 参数 标志 认证 方案 和 可 应 用 到 代理 的 该 URL 上 | Proxy-Authenticate: Basic 
的 参数 
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( 续 表 ) 
Header 解释 示例 
refresh 应 用 于 重 定向 或 一 个 新 的 资源 被 创造 , 在 10 秒 之 后 | Refresh: 10; url-http;//www.cnblogs. 
重 定向 (由 网 景 提出 ， 被 大 部 分 浏览 器 支持 ) com/laoqing/p/8542487.html 
Retry-After 若 实体 暂时 不 可 取 ， 则 通知 客户 端 在 指定 时 间 之 后 | Retry-After: 150 
再 次 尝试 
Server Web 服务 器 软件 名 称 Server: Apache/1.2.30 (Unix) 
(Red-Hat/Linux) 
Set-Cookie 用 来 设置 HTTP Cookie Set-Cookie: UserID=Robot: 
Max-Age-3000; Version=1 
Trailer 是 一 个 响应 首部 ， 标 志 着 允许 发 送 方 在 分 块 发 送 的 | Trailer: Max-Forwards 


消息 后 面 添加 额外 的 元 信息 ， 这 些 添加 的 元 信息 可 
能 是 随 着 消息 主体 的 发 送 动态 生成 的 ， 例 如 消息 的 
完整 性 校 验 、 消 息 的 数字 签名 认证 或 者 消息 经 过 处 
理 之 后 的 最 终 状 态 等 


告知 代理 客户 该 端 响应 是 通过 哪里 发 送 的 1.0 fred, 1.1 nowhere.com 
"s 3) 


Warning 一 个 通用 消息 首部 ， 包 含 当前 消息 状态 可 能 存在 | Waming: 111 Revalidation Failed 
She 在 响应 中 可 以 出 现 多 个 Warning 首部 : 
© 110:Response is Stale (由 缓存 服务 器 提供 的 响应 
CD 
© 111:Revalidation Failed (由 于 无 法 访问 服务 器 ， 响 
应 验证 失败 7 
© 112:Disconnected Operation (缓存 服务 器 断 开 连 
接 ) 
© 113:Heuristic Expiration (如 果 缓 存 服 务 器 采用 启 
发 式 方法 ,将 缓存 的 有 效 时 间 设 定 为 24 小 时 ， 而 在 
该 响应 的 年 龄 超过 24 小 时 时 发 送 ) 
* 199:Miscellaneous Waming (任意 的 、 未 明确 指定 
的 警告 信息 ) 
© 214:Transformation Applied (由 代理 服务 器 添加 ， 
如 果 它 对 返回 的 展现 内 容 进 行 了 任何 转换 ， 比 如 改 
变 了 内 容 编码 、 媒 体 类 型 等 ) 
* 299:Miscellaneous Waming (与 199 类 似 ， 只 不 过 
指 代 的 是 持久 化 警告 ) 
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(BER) 


Header 解释 示例 


WWW-Authenticate | 响应 头 定义 了 使 用 何 种 验证 方式 去 获取 对 资源 的 连接 | WWW-Authenticate: Basic 


虽然 HITP 的 Response Header 类 型 众多 ， 但 是 并 不 是 所 有 的 请 求 都 会 返回 表 3-1-1 中 提 
到 的 每 一 种 Response Header 类 型 。 
【示例 】 访 问 苏宁 易 购 网 站 上 的 HTTP 推荐 接口 ， 使 用 Get Response Header 关键 字 获 取 
返回 的 HTTP. 头 部 为 Content-Type 的 数据 ， 如 图 3-1-17 所 示 。 


Create Http Context tuijian.suning.com scheme=http 

GET 
/recommend-portal/recommendv2/biz.jsonp?callback-showFinal&parameter-$E7$ 

AC$94$E8*AESBOSE6S9CSAC&sceneIds-2-1&count-5&cityId-9173&price-&brandCode- 

$(header)  GetResponse Header Content-Type 

log ${header} 


Get Response Header Content-Type 


图 3-1-17 
执行 结果 如 图 3-1-18 所 示 。 


= pose! HitpLixaryHTIP. GET /recommend-portal/recommendy2/biz jsonp?callback=showFinaláparameter=%E7%AC%94%E8%AE%B0%E6%9C%AC& scenelds=2- 
count=S6cityid=9173&price=8 brandCode= 


Documentation: Issues a HTTP GET request. 

Start /End /Elapsed: — 20170415 00:32:27.151 /20170415 00.3227 29410000.00.143 
- S(header) = HttpLiraryHTTP.Get Response Header Content-Type 

Documentation: Get the response header with the name "header name 

Start/End/ Elapsed: — 20170415 00:32:27.295 /20170415 003227 296 /00:00:00.001 

00:32:27,296 — INFO ${header} = D application/ javascript; charset=UTF-8 ] 


- Bult Log Slheader} 
Documentation: Logs the given message with the given level. 


Start / End / Elapsed: 20170415 00:32:27 297 / 20170415 00:32:27 299 / 00:00:00.002 
00:32:27.298 — INFO U application/javascript; charset=UTF-8' ] 


图 3-1-18 


从 返回 的 结果 看 ， 我 们 获取 到 的 Content-Type W application/javascript; charset=UTF-8。 


3.1.6 Set Request Header 


Set Request Header 关键 字 用 来 设置 HTTP 请 求 时 的 请 求 头 部 信息 ， 接 收 [ header name | 
header value] 两 个 参数 。 

【示例 】 设 置 HITP 请 求 时 的 Referer (Referer 是 header 的 一 部 分 ， 当 浏览 器 向 Web 服 
务 器 发 送 请 求 的 时 候 ， 一 般 会 带 上 Referer， 告 诉 服务 器 我 是 从 哪个 页 面 链接 过 来 的 ， 服 务 器 
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基于 此 可 以 获得 一 些 处 理 信息 。Referer 可 以 用 来 做 一 些 安全 方面 的 校 验 等 ) 为 url: 
https://passport.cnblogs.com/user/signin?ReturnUrl=http://i.cnblogs.com〔 如 图 3-1-19 所 示 ) o 


Set Request Header Referer 
https://passport.cnblogs.com/user/signin?ReturnUrl-http://i.cnblogs.com/ 


Set Request Header Referer [ 


3-1-19 
执行 结果 如 图 3-1-20 所 示 。 


- HttpLibraryHTTP. Set Request Header Referer, https //passport cnblogs com/user/signin?RetumUfl-http://i cnblogs com/ 


Documentation: Sets a request header for the next request. 
Start/End/Elapsed: — 20170415 13:36:49 791 /20170415 13:36:49 791 / 00:00:00.000 
13:38:49. 731 INFO Set request header "Referer" to “https://passport. cnblogs. con/user/si gnin?Returnlirl=http://i. cnblogs. con/^ 


图 3-1-20 


3.1.7 Set Request Body 


Set Request Body 关键 字 用 来 设置 HTTP 请 求 时 的 body 信息 , 尤其 是 在 post 请 求 时 经 常 
需要 用 到 这 个 关键 字 。 

该 关键 字 接收 [ body ] 一 个 参数 。 

【示例 】 登 录 博 客 园 (http://www.cnblogs.com/) 时 ， 设 置 登录 请 求 时 的 body 为 : 


{"input1" : "V+bOQYKu0ZQOxXtauwxpGZC4 YvvxwL16/zA9U6Hx2J0xXDZIpDXT2Fzravj 7AiR5YDsSq 
EUkYZFnB-komrnfzF5dzBHXN3FOxHdQ5oRoMdDHh/zdxTUuqg/9ev4V4yyT9T8V9fElmxs-*BVrF2k 
NZU35VtkaftQW8qnO08Tl0GgdzEZY-","input2":"GAK4VTm2i-*a/6bLHRIu8/oEeKJKav3SrU/DS 
51300BmD/Xk6PEd0vk8GuLs6/obV3dl-*y8Hub2Ey9-4*pO6ip53KIsNKPOeU1lyOPOaCIxMGK0jWcs-*y 
dClgeNOKRvxNl1O/LTcWlhrXVcRBRAAhRcezdT2OTbYEA4frZKIMShHqz-*sE-","remember":false 
} 


Set Request Body 

("inputl":"V-bOQYKu0ZQXtauwxpGZCAYvvxwLI6/zA9U6Hx2JxXDZIpDXT2Fzravj 7AiR5Y 
DsSqEUkYZFnB-*komrnfzF5dzBHXN3FOxHdQ5oRoMdDHh/zdxTUuqg/9ev4VAyyT9T8V9fElmxs-BV 
rF2kNZU35VtkaftQW8qnO08TlO0GgdzEZY-","input2":"GAK4VTm2i-*a/6bLHRIu8/OoEeKJKav3Sr 
U/DS51300BmD/Xk6PEd0vk8GuLs6/obV3dl-*y8Hub2Ey9-*pO6ip53KIsNKPOeUlyOPOaCIxMGK0jW 
cs+ydClgeNOKRvxN10/LTcWlhrXVcRBRAAhRcezdT20TbYE4frZKIMShHqzt+sE=", "remember": £ 
alse} 


执行 结果 如 图 3-1-21 所 示 。 


E Wick braryHTTP. Set Request Body 00.00 
‘ng tbOQYKuOZOXtauwepGZCAY ren I6/24 96 32 xXXDZIpDXT 2Farayj7 AiRSY DsS gE UkY ZF nBekommtzF Sd EXN3FOxHdOSoRoMdDHh/zdxTUuog Se AV 4/TSTE VEI miss B VIF 2INZ USE Vtkaft WEqn08T 10) 
Documentation: Satthe request body forthe next HTTP 
Start End Elapsed: — 20170415 1257 17.682 20170415 
asne WO body set te ° 
VOGEL avr SCELTE VR JeLICTSLETZE 
els?" "ingot "GALT t SEDET IET VISITER 
IME TKDN higra”, “remendar”: e 


1000000000 


TAISTDsS BUDE nra PSOE RCS KAS LB EH rdg Sev y TITEL TIE IST ta DT. 
PEA 2p rS SEI MPO V DDR IUD Yes Re IC/LTe hs DR cen 207. 


3-121 


49 


Robot Framework 自动 化 测试 框架 核心 指南 


3.1.8 Post 


在 HTTP 协议 中 , 除了 get 请 求 外 , 另 一 个 常用 的 就 是 post 请 求 了 。 和 get 请 求 类 似 , post 
请 求 接收 [url ] 一 个 参数 。 
【示例 】 调 用 博客 园 Chttp:/www.cnblogs.com/) 的 认证 接口 (https://passport.cnblogs.com 
/user/signin) 进行 用 户 登 录 认 证 ， 如 图 3-1-22 所 示 。 


Create Http Context passport.cnblogs.com scheme=https 
Set Request Header Cookie 
-Cnblogs .AspNetCore .Cookies=C£DJ8Mmb50BERd5FqtiQlKZZ1G41TLord2gXc8xTMoVr _ 
fYAteG8 9cxt vnObw-OyydeaaiQE8oRPEHPrSvwWU32AGKXmVCEtOoQiuKIniNKqCvx2XNf£ChBRcA47 
BDeEPA4Il6EgeJ6ofQcdG62gNlc-xbk9bgcs7VlyYqUvNYW tk2dd6Ffei77JuquWXwguCeGtVo4qt 
GpUXLcCPlYEWibXawE4ywbdovJTTihZD7yQB301jzQjiUv2Q5Bvcsqdz yKUxRcgxxSzcHqyDGGslL4 
Sdvn7ho047ypsdFkgrafsfmzIpQl; ga-GAl.2.751066332.1492229820; SERVERID-9b2e527d 
e1fc6430919cfb3051ec3e6c|1492230251|1492230186 
Set Request Header Referer 
https://passport.cnblogs.com/user/signin?ReturnUrl-http://i.cnblogs.com/ 
Set Request Body 
("inputl":"V-bOQYKu0ZQXtauwxpGZCAYvvxwLI6/zA9U6Hx2JxXDZIpDXT2Fzravj7AiR5Y 
DsSqEUkYZFnB-tkomrnfzF5dzBHXN3FOxHdQ5oRoMdDHh/zdxTUuqg/9ev4VAyyT9T8V9fElmxs-BV 
rF2kNZU35VtkaftQW8qnO8TlO0GgdzEZY-","input2":"GAK4VTm2i-*a/6bLHRIu8/oEeKJKav3Sr 
U/DS51300BmD/Xk6PEdOvk8GuLs6/obV3d1+y8Hub2Ey9+p06ip53KIsNKPOeU1 y0 POaCIxMGKOjW 
cs+ydClgeNOKRVxN10/LTcWlhrxVcRBRAAhRcezdT20TbYE4frZKIMShHqz+sE=", "remember": f£ 
alse} 


POST /user/signin 
${status} Get Response status 
$ {body} Get Response Body 

log ${body} 

log ${status} 


Create Http Context passport.cnblogs.com 

Set Request Header ‘Cookie 

[Set Request Header Referer 

Set Request Body Tinput1": V +bOQYKu0ZQxXtauwxp || 

POST [user [signin. 

|$ (status) Get Response status. 

|$(body) Get Response Body 

loo {body} 

log {status} 

图 3-1-22 

执行 结果 如 图 3-1-23 所 示 。 
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= CALI hnayhmp.setRequest Header Referer, htips /passpori ntlocs com/userisgrir?RetumUt=tinp /fi cnbiogs comi 000000000 |v a) 9) 
Documentation: 
Start! End | Elapsed: 
14:13:51,583 INFO Set request header “Referer” to “bitps://passpert coblegs con/usar/si prt i atlaga con!” 


“a eren rary HTTP. Set Request Body 000000 000 
OoYKu0ZOXtaumpGZC4Yw WaseuehaiaDapDXDFaajyARSYDsS:EUNTFBHonnaFstBHGFOHOSRabdDHupirUungsexVayTSTSVaEmeyEVENDUSSViahowannban 
Documentation: ‘Satthe request body forthe next HTTP request. 

Start/End Elapsed: 20170415 41351 563 20170415 41351 563/00000000 

nss ER n 


"ROGERSON asp 2I ee 16) AER PTX UTAT eas RDS ERE Shenae BURETO HARE DO eT Ges / Dna HEV TLATOS tef QUO DU. 
"input": GAVIN FERRI sEeCor3S BSSISODBu/ PL rl /rc 4yHak Ey Shp ST SHIP eL? CTS Hest] e LL eV RRA eer TOT 
A "rer": fal". 


- G] ntum POST n "sasin 000000717 
Documentation: Issues a HTTP POST request. 


Start End! Elapsed: 20170415 14:13:51 563120170415 14.1352 280000000 717. 
- GT] status) = HrttrayHTIP Get Response Status n 000 
Documentation: Retrs the response status ine (2.200 OK" or "404 Not ound”) 
‘Start | End / Elapsed: 2017041! 52.280 / 20170415 14:13:52.280 / 00:00:00.000 
M 13:52.280 INFO Sint x 
= SET] :bo = HtbübrayHTTP. Get Response Body (00:00:00 000 
Documentation: Get ine response body. 
Start /End Elapsed: — 20170415 141352280 20170415 141352280 000000 000 
14:13:52.280 INFO [edy] = {*suecess” Ealse) 


- CELT sum.Loo 50:6) 000600070 


Documentation: ge wih te given level 


Start/End Elapsed: 1 120170415 54.1352 280/002010 000 

MOXSL2D — INFO ues find 

= [BRIGED] um Log sat v0.0.0 on 
Documentation: Logs the given message wih the given level. 


Start/End Elapsed: — 20170415 14:13:52.280 /20170815 14.1352 280/0020 00 000 
14:13:52,280 — INFO 200 0E 


图 3-1-23 


从 执行 结果 看 ， 我 们 认证 失败 了 ， 请 求 返回 的 内 容 为 {"success":false}， 但 是 请 求 返 回 的 
HTTP code 为 200 OK， 说 明 HTTP post 请 求 已 经 发 送 成 功 了 。 


3.1.9 Follow Response 

Follow Response 关键 字 用 于 处 理 HTTP 中 的 重 定向 请 求 。 常见 的 HTTP 重 定向 请 求 包 含 
HTTP code 为 301 和 302 的 两 种 重 定向 请 求 ， 如 表 3-1-2 所 示 ， 代 表 着 某 个 URL 地 址 发 生 了 
转移 。 


表 3-1-2 301 和 302 两 种 重 定向 请 求 


redirect: 301 代表 永久 性 转移 (Permanently Moved) 
redirect: 302 代表 暂时 性 转移 《Temporarily Moved) 


【示例 】 调 用 博客 园 (http://www.cnblogs.com/) 的 认证 接口 (https://passport.cnblogs.com 
/user/signin) ， 进 行 用 户 登录 认证 。 在 请 求 时 ， 没 有 设置 Cookie 这 个 HTTP Header f, HTTP 
code 会 返回 302 ， 在 使 用 Follow Response 关键 字 后 会 继续 使 用 重 定 向 后 的 url 进行 请 求 ， 如 
图 3-1-24 所 示 。 
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Create Http 
Context 

Set Request https://passport. cnblogs. com/user/signin?ReturnU 
Header Referer rl=http://i. cnblogs. com/ 


:input1”:“VY+bOQYKu0ZQXtauwxpGZCdYvvxwLI6/7zk9U6H 
x2] xXDZIpDXT2F zravj7AiR5SYDsSqEUkY ZFnBtkomrnizF5d 
zBHXN3FOxHdQ5oRoMdDHh/zdzTUuqg/9ev4V4yyT9T8V9fEl 
nxs+BVrF 2kNZU35V tkaf tQW8qn08T10GgdzEZY=", "input2 
Set Request Body |':'"GAK4VTn2i*a/6bLHRIuB/oEeK]Kav3SrU/DS51300EnD/ 
(Xk6PEdOvk8GuLs6/obV3dl*y8Hub2Ey9*pO6ip53KIsNKPOe 
I1yOPOaCIxMGKOjWcs*ydClgeNOKRvxNlO/LTcWihrXVcRER 
|kAhRcezdT20TbYE4frZKIMShHgz*sE-", “remember” :fals 


passport. cnblogs. com schene=https 


e} 
Follow Response | 
$istatus} Get Response status 
$ {body} Get Response Body 


log $ {body} 


log |t {status} 


3-1-24 


执行 结果 如 图 3-1-25 所 示 。 


Hobroy TIP. Sot Request Header Referer Mips passport crb og: com user agn Relum ilH T rog: com Tm 
Documentation: Sets a request header tor ne next request. 
Sun End 'Elapsed: 201: 


43:305 07:00:00 091 
uswa, aleea conj 


19:50:40,995 INFO) s. 


- GSR par Se Roque Body m 
rp Ue cOQYKuZ Xam p CIV von II zASUBH JX DZI PONTIF aj 7ARRSYDRSGEURY ZF nB mmmtaf de BEXN AF OsFdC SR MADH dT STAVE isse VF NZUS Van Wenn 08 


Documortaten: ser for he ne HTTP request 
Start Eng /Elapsed: 2017044 20170418 145242307 002020001 
1450.45.98 INFO) Henn 
[o ago D0ANean CIAO ICT UEE u or TA STDS TO nea 72D MTITOS MINE AMM) Un /De Erv TETUICEu TOME OPO CET? 
ogee, "aputa Caving a SAL eater ESL In BE FD n Ly E S HIVER er RU L0/LI is ASA Qk eT 
ao 
- CEI wawani POST users 000.06 
Documoraten: Issues a HTTP POST request 


SAU End Elapsed: 20170415 1458:42 207 / 20170416 1458-44083 /000000 668 
- CELEI itouaroryiTip.Follow Response 0000 08 
Documentation: Follows redirect f tne crevicus resocnse status coce was a 301 or 302. 
Siart /End "Elapsed: — 2070115 1458.441083 / 20170418 1458 44.129/002020 015 
> CEEI Status) = wwuorayrrm Get Rosponee Sta 00 0200 0X 
Documentation: tur ne /esponae status Ine (9.9. 209 CK ol "04 Nobunz) 
Start End Elapsed: — 20170414 4 5642 129/ 20170415 1458.44 129/090000 000 
aswa NEO) diteter] = am OÇ 
- CELEI $04) = hpuhownrp.Get Response Body 0000.0 
Documentation Gate response boc 
Start End Elapsed: 20170415 14:52:44.129 20170496 1498-44145 000020015 
14:50:44. 145 INFO Siod) = 
am 
Ew 


m 


vittae esit /> 


tt ie 
-CE eo Log Rea] 6053509 
Documematon: Logs he diven esspe wih e iron level 

rt En/Ennwet:_ aoroutsscsesager zones AREA EÑN (000000800 

imer ET 


从 返回 的 结果 看 ， 在 使 用 了 Follow Response 关键 字 后 会 继续 使 用 重 定向 后 的 url 进行 请 
求 ， 最 后 返回 的 HTTP code 为 200 OK. 


3.1.10 HttpLibrary HTTP 库 的 其 他 关键 字 
表 3-1-3 中 描述 了 HTTPLibrary.HTTP 库 中 其 他 关键 字 的 用 法 。 
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表 3-1-3 HTTPLibrary.HTTP 库 中 其 他 关键 字 的 用 法 


关键 字 使 用 描述 

向 服务 器 端 发 送 HTTP delete 请 求 ， 接 收 一 个 参数 [ url ]， 请 求 的 方式 和 post 请 求 非常 
DELETE 类 似 ， 示 例 ; 

DELETE | / utils/config.htm 

向 服务 器 端 发 送 HTTP HEAD 请 求 ， 接 收 一 个 参数 [ wl ]， 请 求 的 方式 和 get 请 求 非常 
HEAD 类 似 ， 示 例 : 

HEAD | / utils/config.htm 

向 服务 器 端 发 送 HTTP PUT 请 求 ,接收 一 个 参数 [ url ] 请 求 的 方式 和 post 请 求 非常 类 
PUT 似 ， 示 例 : 


PUT [ / utils/config.htm 


Get Json Value 


Json Value Should 
Equal 


Json Value Should 
Not Equal 


获取 Json 字符 串 中 某 个 节点 的 值 ， 示 例 ; 


$ {value} Get Json Value {"foo": 


1.2.3] ) 


一 个 断言 关键 字 ， 用 来 判断 Ison 字符 串 某 个 节点 对 应 的 值 是 不 是 和 预期 一 致 ， 示 例 ; 
Set Variable {"foo": ("bar": 


("bar": | /foo/bar 


Should Be Equal 


Json Value Should 
Equal 


一 个 断言 关键 字 ， 用 来 判断 Ison 字符 串 某 个 节点 对 应 的 值 是 不 是 和 预期 不 一 致 ， 当 不 
一 致 时 ， 执 行 成 功 ， 否 则 执行 失败 ， 示 例 : 


$(jsonj Set Variable ("foo": 


1,2,3 


打印 出 HITP 请 求 执行 后 的 Response Body 内 容 。 该 关键 字 一 般 在 post 请 求 或 者 get 


{"bar": 


Json Value Should 
Not Equal 


Log Response Body | 请 求 发 出 后 使 用 ， 接 收 一 个 参数 [ log level=INFO ]， 在 没有 传 入 日 志 级 别 参数 时 ， 默 
认 使 用 info 级 别 来 打印 日 志 

an 打印 出 HTTP 请 求 执行 后 的 Response Headers 内 容 。 该 关键 字 一 般 在 post 请 求 或 者 get 

mu s 请 求 发 出 后 使 用 ， 接 收 一 个 参数 [ log level=INFO ]， 在 没有 传 入 日 志 级 别 参数 时 ， 默 


认 使 用 info 级 别 来 打印 日 志 


Log Response Status 


打印 出 HITP 请 求 执行 后 的 Response Status 状态 码 该 关键 字 一 般 在 post 请 求 或 者 get 
请 求 发 出 后 使 用 ， 接 收 一 个 参数 [ log level=INFO ]， 在 没有 传 入 日 志 级 别 参数 时 ， 默 
认 使 用 info 级 别 来 打印 日 志 
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(BER) 
关键 字 使 用 描述 
一 个 断言 关键 字 ， 用 来 判断 HTTP 请 求 响应 后 的 Response Body 中 应 该 需要 包含 的 内 
容 ， 接 收 一 个 参数 [ should_contain〈 包 含 的 内 容 ) ]， 示 例 : 
Response! — Body Gar /foo xml | 
Should Contain = - 
Response Body Should Contain version-" 1.0" 
Response Body Should Contain encoding-"UTF-8" 
一 个 断言 关键 字 ， 用 来 判断 HTTP 请 求 响应 后 的 Response Header 是 否 和 预期 一 致 ， 接 
Response Header | 收 [header name | expected] 两 个 参数 ， 示 例 : 
Should Equal Response Header Should | Content-Type text/html: charset=utf-8 
Equal 
一 个 断言 关键 字 ， 和 Response Header Should Equal 刚好 相反 ， 用 来 判断 HTTP 请 求 响 
应 后 的 Response Header 是 否 和 预期 不 一 致 ， 在 不 一 致 时 ， 执 行 成 功 ， 否 则 执行 失败 ， 
e Fa 接收 [header name | not expected] 两 个 参数 ， 示 例 : 
Response Header Should text/html; charset=utf-8 
Not Equal 
一 个 断言 关键 字 ， 用 来 判断 HTTP 请 求 响应 后 的 Response Header 中 是 否 包含 预期 的 
Response Should |header 名 称 ， 接 收 一 个 参数 [ header_name ]， 示 例 : 
Have Header Response Should Have | Content-Type 


Response Should Not 
Have Header 


Response Status Code 
Should Equal 


Header 


一 个 断言 关键 字 , 用 来 判断 HTTP 请 求 响应 后 的 Response Header 中 是 否 不 包含 预期 的 
header 名 称 ， 接 收 一 个 参数 [ header name ]， 示 例 : 
Response Should Not 
Have Header 


一 个 断言 关键 字 用 来 判断 HTTP 请 求 响应 后 的 Response status code 是 否 和 预期 一 致 , 
接收 一 个 参数 [ status_code ]， 示 例 : 
Response Status Code | 200 

Should Equal 


Content-Type 


Response Status Code 


一 个 断言 关键 字 ， 用 来 判断 HTTP 请 求 响应 后 的 Response status code 是 否 和 预期 不 一 
致 ， 若 不 一 致 ， 则 执行 成 功 ， 和 否则 执行 失败 。 该 关键 字 接 收 一 个 参数 [ status code ], 
示例 : 


saa Response Status Code | 200 | 
Should Not Equal 
ee ee 该 关键 字 用 来 设置 HTTP 请 求 时 的 host 名 称 ， 现 在 一 般 很 少 使 用 ， 推 荐 使 用 Create 
ENTIS HTTP Context 关键 字 来 普 代 该 关键 字 
该 关键 字 用 来 设置 HITP 请 求 时 的 Basic Auth(Basic Auth 简单 点 说 明 就 是 每 次 请 求 API 
Set Basic Auth 时 都 提供 用 户 的 username 和 password)， 该 关键 字 接收 [ username | password] 两 个 参 


数 
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(BER) 


关键 字 使 用 描述 


该 关键 字 用 来 设置 Json 字符 串 中 某 个 节点 的 值 ， 示 例 ; 


12 


Set Json Value 


Log Json 


Stringify Json 


Stringify JSON 


使 用 默认 的 浏览 器 来 显示 最 后 一 次 HITP 请 求 的 Response Body 


Show Response Body 
In Browser 

该 关键 字 是 一 个 断言 关键 字 ， 用 来 判断 某 个 字符 串 是 不 是 一 个 有 效 的 Json 字符 串 ， 示 
例 : 


should Be Valid Json 


Should Be Valid Json 


该 关键 字 用 来 解析 一 个 Json 字符 串 ， 示 例 : 


Parse Json 


Parse Json 


存在 多 次 请 求 时 ， 该 关键 字 用 来 判断 下 一 次 请 求 应 该 需要 执行 成 功 。 使 用 该 关键 字 时 ， 
一 般 至 少 需要 存在 两 次 请 求 。 在 HTTP 请 求 中 ， 很 多 请 求 都 有 一 个 特性 ， 即 守 等 ， 比 
如 get 请 求 、head 请 求 等 都 是 究 等 的 请 求 ， 即 执行 一 次 和 执行 多 次 都 应 该 是 成 功 的 ， 

返回 的 结果 应 该 都 是 一 致 的 。 在 执行 第 二 次 HTTP 请 求 时 ， 返 回 的 HTTP code>=400 


Next Request Should 
Succeed 


时 ， 会 认为 第 二 次 请 求 执行 失败 了 。 示 例 : 


/user/signin/aa.htm 


Next Request Should Succeed 
| GET /user/signin/aa.htm. 


存在 多 次 请 求 时 ， 该 关键 字 用 来 判断 下 一 次 请 求 不 应 该 执行 成 功 。 使 用 该 关键 字 时 ， 
一 般 至 少 需要 存在 两 次 请 求 。HITP 请 求 中 ， 也 有 很 多 请 求 是 非 肾 等 的 ， 比 如 常用 的 
post 请 求 就 是 一 个 典型 的 非 涌 等 请 求 ， 即 执行 一 次 和 执行 多 次 ， 执 行 的 结果 不 一 定 都 
Next Request Should | 是 一 致 的 。 在 执行 第 二 次 HTTP 请 求 时 ， 返 回 的 HTTP code<400 时 ， 会 认为 第 二 次 请 


Not Succeed 求 执行 成 功 了 。 示 例 : 
| post fuser/signin | 
| Next Request Should Not Succeed | 
POST /user/signii 
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(BER) 


关键 字 


使 用 描述 


Next Request Should 
Have Status Code 


存在 多 次 请 求 时 ， 该 关键 字 用 来 判断 下 一 次 HITP 请 求 返 
致 ， 示 例 : 

POST 

Next Request Should Have Status Code 


m 


的 code 值 是 否 和 预期 一 


/user/signin 
302 
/user/signin 


Next Request May 
Not Succeed 


该 关键 字 和 Next Request Should Succeed 关键 字 类 似 。 使 用 该 关键 字 时 ， 一 般 至 少 需 
要 存在 两 次 请 求 ， 在 下 一 次 请 求 返回 的 HITP code>=400 时 ， 会 认为 下 一 次 请 求 执行 
失败 了 。 示 例 ; 


POST /user/signin 
Next Request May Not Succeed 
POST /user/si; 


RequestsLibrary 库 的 使 用 


通过 访问 GitHub 地 址 https://github.com/bulkan/robotframework-requests/#readme 可 以 下 载 
和 安装 RequestsLibrary 库 ， 如 图 3-2-1 所 示 。 


C Te == |m 


<> Code 


E) uCENsEmd 


安装 方式 也 可 以 通过 如 下 
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E bulkan / robotframework-requests 


GitHub ie home to ovar 28 milion de T [s] 

and review code. manage projects, and build sofware together 

Robot Framework keyword library wrapper for requests http//bulkan gthubic/robotiramewor. 
257 commit ya $14 release £8.25 coeur deem 


p= //glthub com/bulkan/robotramewark Tequests/ Te dim: 


Join GitHub today 


令 行 进行 在 线 安 装 : 


第 3 章 HTTP 接口 自动 化 测试 


pip install -U requests 
pip install -U robotframework-requests 


安装 完成 后 ， 使 用 时 需要 在 RIDE 中 导入 RequestsLibrary 库 ， 如 图 3-2-2 所 示 。 


Edit | Text Edt | Run 


TestSute12 

Source F:\project\RobotFrameworkTest! (RobotFrameworkTest1 VTestSute12.txt 
Settings >> 

Import Name / Path Arguments Comment 

Library RequestsLibrary 


3-2-2 


3.2.1 Create Session 和 Get Request 


1. Create Session 
Create Session 关键 字 用 来 向 HTTP 服务 端 创建 一 个 Session， 接 收 [ alias | url | headers={} | 
cookies=None | auth=None | timeout=None | proxies=None | verify=False ] 八 个 参数 ， 相 关 介 绍 如 
表 3-2-1 所 示 。 
表 3-2-1 Create Session 关键 字 的 参数 说 明 


参数 名 称 使 用 说 明 

url HTTP 服务 端的 url 地 址 

alias RobotFramework 对 创建 的 Session 进行 重 命名 

headers HTTP 请 求 的 header， 默 认 不 传 入 时 为 空 ， 若 需要 传 入 ， 则 以 字典 的 形式 传 入 

auth HTTP 服务 基本 AUTH 验证 时 需要 的 用 户 名 和 密码 ，HTTP auth 是 一 种 基础 的 用 户 验 证 
timeout 请 求 服务 端 时 的 超时 时 间 设 置 

proxies 访问 HITP RH HTTPS 服务 时 ， 需 要 的 代理 方式 

cookies 需要 设置 的 cookies 值 

veri: 如 果 向 服务 端 请 求 时 需要 验证 证 书 ， 那 么 需要 设置 为 True， 默 认为 False 


2. Get Request 
Get Request 关键 字 用 来 在 创建 好 Session 的 基础 上 向 服务 端 发 送 一 个 get 请 求 , 接收 [alias 
| uri | headers=None | params={} | allow_redirects=None ] 五 个 参数 ， 相 关 介 绍 如 表 3-2-2 所 示 。 


表 3-2-2 Get Request 关键 字 的 参数 说 明 


使 用 说 明 

Create Session 关键 字 执行 后 创建 的 Session 别名 , 也 就 是 在 Create Session 关键 字 执行 时 
alias 参数 填 入 的 值 

i HTTP 服务 端的 uri 地 址 

| headers HTTP 请 求 的 header， 默 认 不 传 入 时 为 空 ， 若 需要 传 入 ， 则 以 字典 的 形式 传 入 

HTTP 请 求 参数 ， 若 需要 传 入 ， 则 以 字典 的 形式 传 入 

allow redirects 允许 重 定向 的 地 址 
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【示例 1】 使 用 Create Session 和 Get Request 关键 字 向 http://robotframework.org/#libraries 
发 送 一 个 get 请 求 ， 如 图 3-2-3 所 示 。 


ICreate Session RobotFramework http: //robotframework.org 
Stresp}= Get Request RobotFramework (/#ibraries 
log S(resp)- 

3-2-3 


运行 结果 如 图 3-2-4 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel2.TestCase0001 

20180822 15:12:50.993 : INFO : Creating Session using : alias-RobotFramework, 
url-http://robotframework.org, headers-(), cookies-None, auth-None, 
timeout-None, proxies-None, verify-False 

20180822 15:12:51.071 : INFO : Starting new HTTP connection (1): 
robotframework.org 

20180822 15:12:52.404 : INFO : Get Request using : alias-RobotFramework, 
uri=/#libraries, headers=None 

20180822 15:12:52.405 : INFO : ${resp} = <Response [200]> 

20180822 15:12:52.406 : INFO : <Response [200]>= 


Ending test: RobotFrameworkTest1.TestSutel2.TestCase0001 
图 32-4 


【示例 2】 我 们 使 用 Create Session 和 Get Request 关键 字 来 请 求 https:/Wtcc.taobao.comycc/ 
json/mobile tel segment.htm 网 站 提供 的 手机 号 码 查询 接口 ， 这 里 的 headers 使 用 创建 字典 的 形 
式 传 入 ， 如 图 3-2-5 所 示 。 


telz15150576251 


https://tcc.taobae.com ${headers} 
tcc /[ec/json/mobile tel segment.htm ${headers} 


图 3-2-5 
运行 结果 如 图 3-2-6 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel2.TestCase0002 
20180822 17:22:01.781 : INFO : ${headers} = {u'Accept': 
u'text/html,application/xhtml-*xml,application/xml;q-0.9,image/webp, */*;q-0.8" 
} 

20180822 17:22:01.784 : INFO : ${param} = (u'tel': u'15150576251'] 

20180822 17:22:01.787 : INFO : Creating Session using : alias-tcc, 
url-https://tcc.taobao.com, headers={u'Accept': 
u'text/html,application/xhtml*xml,application/xml;q-0.9,image/webp, */*;q=0.8" 
), cookies-None, auth-None, timeout-None, proxies-None, verify-False 

20180822 17:22:01.804 : INFO : Starting new HTTPS connection (1): tcc.taobao.com 


3-2-6 
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20180822 17:22:02.537 : INFO : Get Request using : alias=tcc, 
uri-/cc/json/mobile tel segment.htm, headers={u'Accept": 
u'text/html,application/xhtml4xml,application/xml;q-0.9,image/webp, */*;q=0.8' 
} 
20180822 17:22:02.538 : INFO : 
C:\Program Files 
(x86) \python\lib\site-packages\requests\packages\urllib3\util\ssl_.py:315: 
SNIMissingWarning: An HTTPS request has been made, but the SNI (Subject Name 
Indication) extension to TLS is not available on this platform. This may cause 
the server to present an incorrect TLS certificate, which can cause validation 
failures. For more information, see 
https://urllib3.readthedocs.org/en/latest/security.html#snimissingwarning. 
SNIMissingWarning 
C:\Program Files 
(x86) \python\lib\site-packages\requests\packages\urllib3\util\ssl_-.py:120: 
InsecurePlatformWarning: A true SSLContext object is not available. This prevents 
urllib3 from configuring SSL appropriately and may cause certain SSL connections 
to fail. For more information, see 
https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarni 
ng. 
InsecurePlatformWarning 
C:\Program Files 
(x86) \python\lib\site-packages\requests\packages\urllib3\connectionpool.py:79 
1: InsecureRequestWarning: Unverified HTTPS request is being made. Adding 
certificate verification is strongly advised. See: 
https://urllib3.readthedocs.org/en/latest/security.html 
InsecureRequestWarning) 
20180822 17:22:02.539 : INFO : ${resp} = <Response [200]> 
20180822 17:22:02.540 : INFO : <Response [200]> 


Ending test RobotFrameworkTestl.TestSutel2.TestCase0002 
图 3-2-6 ( 续 ) 


3.2.2 Post Request 


Post Request 关 键 字 用 来 在 创建 好 Session 的 基础 上 向 服务 端 发 送 一 个 post 请 求 ,接收 [alias 
| uri | data={} | headers=None | files={} | allow_redirects=None ] 六 个 参数 。 其 中 ，data、headers、 
files 这 几 个 参数 ， 如 果 需 要 传 入， 那么 都 应 该 以 字典 的 形式 传 入 。 

【示例 】 向 https://getman.cn 网 站 提供 的 测试 接口 提交 一 个 post 请 求 ， 如 图 3-2-7 所 示 。 


图 3-2-7 


执行 结果 如 图 3-2-8 所 示 。 


Starting test: RobotFrameworkTestl.TestSutel2.TestCase0003 

20180825 10:29:07.923 : INFO : ${data} = (u'book': u'RobotFramework'] 
20180825 10:29:07.925 : INFO : Creating Session using : alias-getman, 
url-https://getman.cn, headers-(), cookies-None, auth-None, timeout-None, 


proxies-None, verify-False 
20180825 10:29:07.941 : INFO : Starting new HTTPS connection (1): getman.cn 


3-2-8 
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20180825 10:29:08.656 : INFO : Post Request using : alias=getman, uri=/echo, 
data={u'book': u'RobotFramework'}, headers=None, file={}, allow s 


 redirects-True 

20180825 10:29:08.658 : INFO : ${resp} = «Response [200]> 
20180825 10:29:08.660 : INFO : «Response [200]» 

Ending test: RobotFrameworkTestl.TestSutel2.TestCase0003 


图 32-8 ( 续 ) 


3.2.3 RequestsLibrary 库 的 其 他 关键 字 
表 3-2-3 中 列 出 了 RequestsLibrary 库 中 其 他 关键 字 的 使 用 方式 。 


表 3-2-3 RequestLibrary 库 中 其 他 关键 字 的 使 用 方式 


关键 字 使 用 描述 

Delete 模拟 向 服务 端 发 送 一 个 Delete 请 求 ， 接 收 [ alias | uri | data-() | headers=None 

allow_redirects=None ] 五 个 参数 ， 不 推荐 使 用 Delete 关键 字 来 发 送 Delete 请 求 ， 推 荐 使 
用 Delete Request 关键 字 来 发 送 Delete 请 求 

Delete Request 模拟 向 服务 端 发 送 一 个 Delete 请 求 ， 接 收 [ alias | uri | data-() | headers=None 

allow redirects=None ] 五 个 参数 ， 推 荐 使 用 该 关键 字 来 发 送 Delete 请 求 


Get 模拟 发 送 一 个 Get 请 求 ， 接 收 [ alias | uri | headers=None | params={} 
allow_redirects=None ] 五 个 参数 ， 推 荐 使 用 Get Request 关键 字 来 发 送 Get 请 求 

Head 模拟 向 服务 端 发 送 一 个 Head 请 求 ， 接 收 [ alias | uri | headers=None 
allow_redirects=None ] 四 个 参数 不 推荐 使 用 该 关键 字 来 发 送 Head 请 求 推荐 使 用 Head 
Request 关键 字 来 发 送 Head 请 求 


Head Request 模拟 向 服务 端 发 送 一 个 Head 请 求 ， 接 收 [ alias | uri | headers=None 

allow redirects=None ] 四 个 参数 ， 推 荐 使 用 该 关键 字 来 发 送 Head 请 求 

Options 模拟 向 服务 端 发 送 一 个 Options 请 求 ， 接 收 [ alias | uri | headers=None 

allow_redirects=None ] 四 个 参数 ， 不 推荐 使 用 该 关键 字 来 发 送 Options 请 求 ， 推 荐 使 用 
Options Request 关键 字 来 发 送 Options 请 求 

Options Request 模拟 向 服务 端 发 送 一 个 Options 请 求 ， 接 收 [ alias | uri | headers-None 

allow_redirects=None ] 四 个 参数 ， 推 荐 使 用 该 关键 字 来 发 送 Options 请 求 

Patch 模拟 向 服务 端 发 送 一 个 Patch 请 求 ， 接 收 [ alias | uri | data={} | headers=None | files={} 

allow_redirects=None ] 六 个 参数 ， 不 推荐 使 用 该 关键 字 来 发 送 Patch 请 求 ， 推 荐 使 用 

Patch Request 关键 字 来 发 送 Patch 请 求 

Patch Request 模拟 向 服务 端 发 送 一 个 Patch 请 求 ， 接 收 [ alias | uri | data={} | headers=None | files={} 

allow_redirects=None ] 六 个 参数 ， 推 荐 使 用 该 关键 字 来 进行 Patch 请 求 发 送 


Put 模拟 向 服务 端 发 送 一 个 Put HR, Hee [ alias | uri | data=None | headers=None 
allow_redirects=None ] 五 个 参数 ， 不 推荐 使 用 该 关键 字 来 发 送 Put 请 求 ， 推 荐 使 用 Put 
Request 关键 字 来 发 送 Put 请 求 

Put Request 模拟 向 服务 端 发 送 一 个 put 请 求 ， 接 收 [ alias | uri | data-None | headers=None 
allow redirects-None ] 五 个 参数 ， 推 荐 使 用 该 关键 字 来 进行 Put 请 求 发 送 

To Json 将 一 个 字符 串 转换 为 一 个 Json 形式 的 对 象 ， 接收 [ content | pretty print-False ] 两 个 参数 

Delete All 删除 创建 的 所 有 Session 对 象 ， 和 Create Session 关键 字 是 相对 应 的 

Sessions 
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RESTinstance 库 的 使 用 


RESTinstance 库 主 要 提供 了 用 于 Restful 服务 的 JSON 请 求 报 文 方式 的 关键 字 ， 可 以 通过 
在 cmd 命令 行 中 输入 “pip install --upgrade RESTinstance” 进 行 在 线 安 装 。 安 装 完成 后 ， 通 过 
如 图 3-3-1 所 示 的 方式 导入 RESTLibrary。 


Edit | Text Edit | Run | Log 


TestSute13 
Source F:\project\RobotFrameworkTesti (RobotFrameworkTest1 | TestSute13.txt 


Settings >> 


Import Name / Path Arguments Comment 
Library REST http://127.0.0.1:8080 


3-3-1 


RESTLibrary 导入 时 ， 可 以 跟 上 需要 请 求 的 RESTful 服务 的 地 址 。 
RESTinstance 库 提 供 的 主要 常用 关键 字 如 表 3-3-1 所 示 。 


表 3-3-1 RESTinstance 库 提 供 的 主要 常用 关键 字 


关键 字 使 用 说 明 
Post 以 RESTful 的 形式 向 指定 的 服务 器 uri 发 送 一 个 post WHA 请 求 时 request body 需要 是 ISON 
的 形式 ， 示 例 : 
Post [emot 7 [ t'booke Rotor] 
Get 以 RESTful 的 形式 向 指定 的 服务 器 uri 发 送 一 个 get 请 求 ， 示 例 : 
Get /bookName 
Put 以 RESTful 的 形式 向 指定 的 服务 器 uri 发 送 一 个 Put 请 求 ， 使 用 的 方式 和 Post 请 求 类 似 
Delete 以 RESTful 的 形式 向 指定 的 服务 器 uri 发 送 一 个 Delete 请 求 ， 示 例 : 
Delete /books/3 
Set Headers ”| 该 关键 字 用 来 设置 HTTP 请 求 时 的 请 求 Headers， 示 例 : 
Set Headers I Í"content-type": "application/json"} 
Array 验证 一 个 RESTful 请 求 返 回 的 响应 结果 是 不 是 一 个 期 望 要 求 的 数组 ， 示 例 : 
Array response body maxItems=20 
Integer 用 来 断言 指定 的 字段 的 返回 值 是 否 和 预期 结果 一 致 ， 一 般 可 以 用 来 判断 RESTful 请 求 返回 的 
HTTP code， 示 例 : 
Integer | Tesponse status | 200 
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Appium 介绍 


Appium 是 一 个 开源 、 跨 平台 的 自动 化 测试 工具 ， 可 以 用 来 测试 Native 及 混合 的 移动 端 应 
FH. Appium 可 以 支持 IOS, Android 及 FirefoxOS 平台 ，Appium 为 了 实现 自身 提出 的 理念 : 
不 必 局 限于 某 种 语言 或 者 框架 来 写 /运行 测试 脚本 ， 以 及 一 个 移动 自动 化 的 框架 不 应 该 在 接口 
上 重复 造 轮子 。 它 把 IOS. Android 等 自身 提供 的 第 三 方 框架 都 封装 成 了 一 套 API， 即 
WebDriver。API.WebDriver (Selenium WebDriver, Appium 对 此 进行 了 扩展 ) 指定 了 客户 端 
到 服务 端的 协议 ， 通 过 这 种 客户 端 /服务 端的 架构 可 以 使 用 任何 语言 来 编写 客户 端 ， 向 服务 端 
发 送 恰当 的 HTTP 请 求 ， 只 要 client 能 够 发 送 http 请 求 给 server, WA client 用 什么 语言 来 实 
现 都 是 可 以 的 ， 这 就 是 appium 及 webdriver 如 何 做 到 支持 多 语言 的 。 

Appium 的 核心 是 一 个 Web 服务 器 ， 提 供 了 一 套 REST 的 接口 。 它 收 到 客户 端的 连接 ， 
监听 到 命令 ， 接 着 在 移动 设备 上 执行 这 些 命令 ， 然 后 将 执行 结果 放 在 HTTP 响应 中 返还 给 客 
户 端 。 

Appium 的 下 载 地 址 为 http://appium.io/downloads.html, 从 中 可 以 下 载 最 新 的 安装 版 本 和 相 
应 的 Library 库 ， 如 图 4-1-1 所 示 。 


Appium Client Libraries 


Appium has language bindings for 


Frame 


Appium Desktop Apps 


Appiums desktop app supports OS X, Y 


© Appium-Desktop for OS 


图 4-1-1 


ik: 本 章 参 考 了 Appium 官网 http-//appium io/slate/cn/master/ 关于 Appium 的 相关 使 用 介绍 。 
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Appium 的 相关 介绍 文档 可 以 通过 访问 http://appium io/slate/cn/master/ 获 取 到 ， 如 图 4-1-2 
所 示 。 


Appium 介绍 


€ Q © appium.io/siate/en, 


& appium 


Ruby bindings 
Python 

Java bindings 

Java Scnpt binaings 
PHP bindings 

C£ bindings 
Appium home page 


Aopum S-P BXEERBGUEB T E , II IOS 平台 和 Android 平台 上 的 不 生 应 用 ， 
web 应 用 和 清 语 应 月 ~ 


重要 的 是 ，Appium 是 一 个 路 平台 的 工具 + 它 允许 到 试 人 员 在 不 同 的 平台 GOS, 
Android) WMA- SAPRE ANEMA, kA IOS 和 Ancrod MLE 
件 间 代码 的 页 用 性 - 


起 知道 Appium 如 何 支持 平台 ， 版 本 和 自动 化 形态 的 洋 归 信息 ， 请 元 见 clattfcm suprot 
doc» 


Appium 的 理念 


为 了 项 足 你 动 自动 化 夫 求 ,Appuum His OAS, GMT EER: 


TIME. MERLE A NOP HARI © 

PRE MAE aM AERA pue CONGUE 
3 一 沾 移动 自动 化 的 yj 论 在 闭口 上 重要 读 轮 于 。( 政 动 自动 化 的 接口 页 资 按 一 ) 
4 RGR TEE EARR: 
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Appium 真正 的 工作 引擎 其 实 是 第 三 方 自动 化 框架 : 


€ iOS: 苹果 的 UlAutomation. 

@ Android 4.2+: 谷歌 的 UiAutomator. 

€ Android 2.3+: 谷歌 的 Instrumentation. Instrumentation 由 单独 的 项 目 Selendroid 提供 
支持 。 


4.1.1 Appium 中 的 常用 术语 
Appium 中 的 常用 术语 有 以 下 几 种 。 


1. Session 

Appium 自动 化 建立 在 一 个 Session 上 运行 , 客户 端 初始 化 一 个 Seesion 来 与 服务 端 进行 请 
求 和 交互 ,客户 端 会 发 送 一 个 POST 请 求 给 服务 端 , 请 求 中 包含 一 个 JSON 对 象 ,被 称 作 “ desired 
Capabilities”。 然 后 ， 服 务 端 就 会 开启 一 个 自动 化 的 Session， 并 且 返 回 一 个 Session ID 给 客户 
端 ， 客 户 端的 后 续 请 求 都 会 带 上 该 Session ID 给 服务 端 做 识别 。 


2. Desired Capabilities 

Desired Capabilities 是 一 些 键 值 对 的 集合 (比如 ， 一 个 map 或 者 hashmap) ， 客 户 端 将 
这 些 键 值 对 发 给 服务 端 ， 告 诉 服务 端 需要 怎么 执行 测试 。 比 如 ， 我 们 可 以 把 
platformNamecapability 设置 为 Android， 告 诉 Appium 服务 端 ， 我 们 想 要 一 个 Android 的 


63 


Robot Framework 自动 人 


Session， 而 不 是 一 个 iOS 的 。 也 可 以 设置 safariAllowPopups capability 为 True, 确保 在 Safari 
自动 化 Session 中 可 以 使 用 JavaScript 来 打开 新 窗口 。 


3. Appium Server 
Appium Server 是 基于 Nodejs 实现 的 ， 可 以 使 用 NPM 直接 安装 。 


4.1.2 Appium 服务 关键 字 
Appium 服务 关键 字 如 下 : 


usage: appium.js [-h] [-v] -shell] 

--localizable-strings-dir LOCALIZABLESTRINGSDIR] [--app APP] 
--ipa IPA] [-U UDID] [-a ADDRESS] [-p PORT] 

-ca CALLBACKADDRESS] [-cp CALLBACKPORT] [-bp BOOTSTRAPPORT] 
-k] [-r BACKENDRETRIES] [--session-override] [--full-reset] 
--no-reset] [-1] [-1t LAUNCHTIMEOUT] [-g LOG] 

--log-level (info,info:debug,info:info,info:warn,info:error,wa 
rn,warn:debug,warn:info,warn:warn,warn:error,error,error:debug,error:info,err 
or: 
warn,error:error,debug,debug:debug,debug:info,debug:warn,debug:error]] 
--log-timestamp] [--local-timezone] [--log-no-colors] 

-G WEBHOOK] [--native-instruments-lib] 

--app-pkg ANDROIDPACKAGE] [--app-activity ANDROIDACTIVITY] 
--app-wait-package ANDROIDWAITPACKAGE] 

--app-wait-activity ANDROIDWAITACTIVITY] 

--android-coverage ANDROIDCOVERAGE] [--avd AVD] 

--avd-args AVDARGS] 

--device-ready-timeout ANDROIDDEVICEREADYTIMEOUT] [--safari] 
--device-name DEVICENAME] [--platform-name PLATFORMNAME] 
--platform-version PLATFORMVERSION] 

--automation-name AUTOMATIONNAME] 

--browser-name BROWSERNAME] [--default-device] 
--force-iphone --force-ipad] [--language LANGUAGE] 
--locale LOCALE] [--calendar-format CALENDARFORMAT] 
--orientation ORIENTATION] 

--tracetemplate AUTOMATIONTRACETEMPLATEPATH] 

--instruments INSTRUMENTSPATH] [--show-sim-log] 
--show-ios-log --nodeconfig NODECONFIG] [-ra ROBOTADDRESS] 
-rp ROBOTPORT] [--selendroid-port SELENDROIDPORT] 
--chromedriver-port CHROMEDRIVERPORT] 
--chromedriver-executable CHROMEDRIVEREXECUTABLE] 
--use-keystore --keystore-path KEYSTOREPATH] 
--keystore-password KEYSTOREPASSWORD] [--key-alias KEYALIAS] 
--key-password KEYPASSWORD] [--show-config] 
--no-perms-check] [--command-timeout DEFAULTCOMMANDTIMEOUT] 
--keep-keychains [--strict-caps] [--isolate-sim-device] 
--tmp TMPDIR] [--trace-dir TRACEDIR] 

—-intent-action INTENTACTION] 

--intent-category INTENTCATEGORY] 
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[--intent-flags INTENTFLAGS] 


[--intent-args OPTIONALINTENTARGUMENTS] 
[--dont-stop-app-on-reset] [--debug-log-spacing] 
[--suppress-adb-kill-server] [--async-trace] 

A webdriver-compatible server for use with native and hybrid iOS and Android 


applications. 

Optional arguments: 
-h, --help Show this help message and exit. 
-v, --version Show program's version number and exit. 
—-SHeblr Enter REPL mode 


--localizable-strings-dir LOCALIZABLESTRINGSDIR 
IOS only: the relative path of the dir where 
Localizable.strings file resides 

--app APP IOS: abs path to simulator-compiled .app file or the 
bundle id of the desired target on device; Android: 
abs path to .apk file 


--ipa IPA (IOS-only) abs path to compiled .ipa file 
-U UDID, --udid UDID Unique device identifier of the connected physical 
device 


-a ADDRESS, --address ADDRESS 
IP Address to listen on 

-p PORT, --port PORT port to listen on 

-ca CALLBACKADDRESS, --callback-address CALLBACKADDRESS 
callback IP Address (default: same as --address) 

-cp CALLBACKPORT, --callback-port CALLBACKPORT 
callback port (default: same as port) 

-bp BOOTSTRAPPORT, --bootstrap-port BOOTSTRAPPORT 
(Android-only) port to use on device to talk to Appium 

-k, --keep-artifacts [DEPRECATED] no effect, trace is now in tmp dir by 
default and is cleared before each run. Please also 
refer to the --trace-dir flag. 

-r BACKENDRETRIES, --backend-retries BACKENDRETRIES 
(i0S-only) How many times to retry launching 
Instruments before saying it crashed or timed out 

--session-override Enables session override (clobbering) 

--full-reset (iOS) Delete the entire simulator folder. (Android) 
Reset app state by uninstalling app instead of 
Clearing app data. On Android, this will also remove 
the app after the session is complete. 

--no-reset Don't reset app state between sessions (IOS: don't 
delete app plist files; Android: don't uninstall app 
before new session) 

=] --pre-launch Pre-launch the application before allowing the first 
session (Requires --app and, for Android, --app-pkg 
and --app-activity) 

-lt LAUNCHTIMEOUT, --launch-timeout LAUNCHTIMEOUT 
(ioS-only) how long in ms to wait for Instruments to 
launch 

-g LOG, --log LOG Also send log output to this file 

-=log-level. 


65 


Robot Framework 自动 { 


框架 核心 指南 


{info, info:debug, info:info, info:warn, info:error, warn, warn:debug, wa 
rn:info,warn:warn, warn:error, error, error:debug, error: info,error:warn,error:er 
ror 
, debug, debug: debug, debug: info, debug: warn, debug:error} 

log level; default (console[:file]): debug[:debug] 


--log-timestamp Show timestamps in console output 
--local-timezone Use local timezone for timestamps 
--log-no-colors Don't use colors in console output 


-G WEBHOOK, --webhook WEBHOOK 
Also send log output to this HTTP listener 
--native-instruments-lib 
(IOS-only) IOS has a weird built-in unavoidable delay. 
We patch this in appium. If you do not want it 
patched, pass in this flag. 
--app-pkg ANDROIDPACKAGE 
(Android-only) Java package of the Android app you 
want to run (e.g., com.example.android.myApp) 
--app-activity ANDROIDACTIVITY 
(Android-only) Activity name for the Android activity 
you want to launch from your package (e.g., 
MainActivity) 
--app-wait-package ANDROIDWAITPACKAGE 
(Android-only) Package name for the Android activity 
you want to wait for (e.g., com.example.android.myApp) 
--app-wait-activity ANDROIDWAITACTIVITY 
(Android-only) Activity name for the Android activity 
you want to wait for (e.g., SplashActivity) 
--android-coverage ANDROIDCOVERAGE 
(Android-only) Fully qualified instrumentation class. 
Passed to -w in adb shell am instrument -e coverage 
true -w 
--avd AVD (Android-only) Name of the avd to launch 
--avd-args AVDARGS (Android-only) Additional emulator arguments to 
launch the avd 
--device-ready-timeout ANDROIDDEVICEREADYTIMEOUT 
(Android-only) Timeout in seconds while waiting for 
device to become ready 
--safari (IOS-Only) Use the safari app 
--device-name DEVICENAME 
Name of the mobile device to use 
--platform-name PLATFORMNAME 
Name of the mobile platform: iOS, Android, or 
FirefoxOS 
--platform-version PLATFORMVERSION 
Version of the mobile platform 
--automation-name AUTOMATIONNAME 
Name of the automation tool: Appium or Selendroid 
--browser-name BROWSERNAME 
Name of the mobile browser: Safari or Chrome 
--default-device, -dd 
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(IOS-Simulator-only) use the default simulator that 
instruments launches on its own 


-—-force-iphone (IOS-only) Use the iPhone Simulator no matter what 
the app wants 
—-force-ipad (IOS-only) Use the iPad Simulator no matter what the 


app wants 
-—-language LANGUAGE Language for the iOS simulator / Android Emulator 
--locale LOCALE Locale for the iOS simulator / Android Emulator 
--calendar-format CALENDARFORMAT 

(IOS-only) calendar format for the iOS simulator 
--orientation ORIENTATION 

(IOS-only) use LANDSCAPE or PORTRAIT to initialize 

all requests to this orientation 
--tracetemplate AUTOMATIONTRACETEMPLATEPATH 

(IOS-only) .tracetemplate file to use with Instruments 
--instruments INSTRUMENTSPATH 

(IOS-only) path to instruments binary 


--show-sim-log (IOS-only) if set, the iOS simulator log will be 
written to the console 
--show-ios-log (IOS-only) if set, the iOS system log will be written 


to the console 
--nodeconfig NODECONFIG 
Configuration JSON file to register appium with 
selenium grid 
-ra ROBOTADDRESS, --robot-address ROBOTADDRESS 
IP Address of robot 
-rp ROBOTPORT, --robot-port ROBOTPORT 
port for robot 
--selendroid-port SELENDROIDPORT 
Local port used for communication with Selendroid 
--chromedriver-port CHROMEDRIVERPORT 
Port upon which ChromeDriver will run 
--chromedriver-executable CHROMEDRIVEREXECUTABLE 
ChromeDriver executable full path 
--use-keystore (Android-only) When set the keystore will be used to 
sign apks. 
--keystore-path KEYSTOREPATH 
(Android-only) Path to keystore 
--keystore-password KEYSTOREPASSWORD 
(Android-only) Password to keystore 
--key-alias KEYALIAS (Android-only) Key alias 
—-key-password KEYPASSWORD 
(Android-only) Key password 


--show-config Show info about the appium server configuration and 
exit 
--no-perms-check Bypass Appium's checks to ensure we can read/write 


necessary files 
--command-timeout DEFAULTCOMMANDTIMEOUT 
The default command timeout for the server to use for 


all sessions. Will still be overridden by 
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newCommandTimeout cap 


—-keep-keychains (iOS) Whether to keep keychains (Library/Keychains) 
when reset app between sessions 
--strict-caps Cause sessions to fail if desired caps are sent in 


that Appium does not recognize as valid for the 
selected device 

--isolate-sim-device Xcode 6 has a bug on some platforms where a certain 
simulator can only be launched without error if all 
other simulator devices are first deleted. This 
option causes Appium to delete all devices other than 
the one being used by Appium. Note that this is a 
permanent deletion, and you are responsible for using 
simctl or xcode to manage the categories of devices 
used with Appium. 

--tmp TMPDIR Absolute path to directory Appium can use to manage 
temporary files, like built-in iOS apps it needs to 
move around. On *nix/Mac defaults to /tmp, on Windows 
defaults to C:\Windows\Temp 

--trace-dir TRACEDIR Absolute path to directory Appium use to save ios 
instruments traces, defaults to «tmp 
dir»/appium-instruments 

--intent-action INTENTACTION 
(Android-only) Intent action which will be used to 
start activity 

--intent-category INTENTCATEGORY 
(Android-only) Intent category which will be used to 
start activity 

--intent-flags INTENTFLAGS 
(Android-only) Flags that will be used to start 
activity 

--intent-args OPTIONALINTENTARGUMENTS 
(Android-only) Additional intent arguments that will 
be used to start activity 

--dont-stop-app-on-reset 
(Android-only) When included, refrains from stopping 
the app before restart 

--debug-log-spacing Add exaggerated spacing in logs to help with visual 
inspection 

--suppress-adb-kill-server 
(Android-only) If set, prevents Appium from killing 
the adb server instance 

--async-trace Add long stack traces to log entries. Recommended for 
debugging only. 


表 4-1-1 中 给 出 了 Appium 服务 相关 参数 的 描述 。 
表 4-1-1 Appium 服务 相关 参数 的 说 明 


参数 描述 

automationName 自动 化 测试 引擎 的 名 称 ， 比 如 Appium (默认 ) 或 Selendroid 
|_platformName 待 测试 的 手机 操作 系统 ， 比 如 iOS. Android 或 FirefoxOS 
LplatformVersion 手机 操作 系统 版 本 
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( 续 表 ) 

参数 描述 

deviceName 手机 device 或 模拟 器 的 device。 在 Android 上 ， 可 以 通过 adb devices 来 得 到 ; 在 
iOS 上 ， 可 以 使 用 instruments -s devices 来 得 到 

app ipa or apk 文件 所 在 的 本 地 绝对 路 径 或 者 远程 路 径 

browserName 待 自动 化 测试 的 手机 的 Web 浏览 器 名 称 ， 如 果 是 对 APP 应 用 进行 自动 化 测试 ， 那 
么 这 个 关键 字 的 值 应 该 为 空 

newCommandTimeout | 执行 命令 超时 时 间 ， 单 位 为 秒 。 如 果 达 到 超时 时 间 仍 未 接收 到 新 的 命令 ， 那 么 
Appium 会 认为 客户 端 退出 ， 然 后 自动 结束 会 话 

autoLaunch Appium 是 否 需 要 自动 安装 和 启动 应 用 ， 默 认为 True 

language 设 定 模拟 器 (simulator / emulator) 的 语言 (Sim/Emu-only) 

locale 设 定 模拟 器 (simulator / emulator) 的 区 域 设置 (SinyEmu-only) 

noReset 不 在 会 话 前 重 置 应 用 状态 ， 默 认 值 为 False 

fullReset Android 上 通过 卸载 而 不 是 清空 数据 重 置 应 用 状态 ,在 Android 上 会 话 结束 后 自动 
清除 被 测 应 用 ， 在 iOS 上 会 删除 整个 模拟 器 目录 

udid 连接 的 物理 设备 的 唯一 设备 标识 

orientation 在 一 个 设 定 的 方向 模式 中 开始 测试 (Sim/Emv-only ) 


Appium Library 库 的 使 用 


在 使 用 Appium Library 库 时 ， 需 要 预先 安装 好 Appium 自动 化 工具 。Appium 官网 地 址 为 
http://appium.io/， 如 图 4-2-1 所 示 。 


Qappium 


Automation for Apps 


Appium is an open source test automation framework for use with native, and mobile web 


apps. 
It drives IOS, Android, and Windows apps using the WebDnver protocol 


Introducing Appium. 


图 4-2-1 
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Appium 的 GitHub 地 址 为 https://github.com/appiuom， 如 图 4-2-2 所 示 。 


o Features Business Explore Pricing This repository S= Sign in or Sign up 
© appium / appium Owech 737 WSter 5127 | York | 2583 
«> Code Issues 683) Pull requests 4 — fM Projects d Pulse Graphs 


B Automation for iOS, Android, and Windows Apps. http://appium.jo/ 


appium  webdriver  ardreid jos windows automation 
加 6151 commits P 42 branches © 119 releases 44 170 contributors 
Branch: master» | New pull request wen. EEE 
E] mykola-mokhnach committed with imurchie Update network connection adjustment information for Android (#8258) Latest commit aB4efcF a day ago 
ii github updated issue template with dear instructions to provide apium lcgs a month ago 
dia bin Add eslint and pre-commit hooks 9 months ago 
iia docs Update network connection adjustment information for Android (#8258) aday ago 
mib Add MacDriver (48046) a month ago 
m est Move to logger trom appium-support 2 months ago 
5) ‘esintigrore Add eslint and pre-commit hooks 9 months ago 


mre Add eslint and mit hooks ths ago 


4-22 


Appium 工具 提供 的 RobotFramework-appiumlibrary 库 的 访问 地 址 为 
https://github.com/serhatbolswrobotframework-appiumlibrary, 41/4] 4-2-3 所 示 。 可 以 通过 pip 在 
线 安装 Library, 也 可 以 在 下 载 好 Library 库 后 采用 “python setup.py install ”的 方式 来 进行 安装 。 


hips //glthab com/serhatbolsu/rabotframework-appkanlibrary 
U serhatbolsu / robotframework-appiumlibrary Owan a7 kesur 120 | Yron |115 
Owe | Oma — TpPulrequess di Hri sebe lli Graphs 


AppiumLibrary is an appium testing library tor RobotFramework 


python rabottramawork appum — oray 


fp 349 commits V 6 branches. © 2B releases At 22 contributors db Apache-20 
lg serhatboisu committed on GitHub Merge pull request #167 from JMenjfec tap = Latest commit 2006096 13 days age 
El aitonore merged with upstream master 2 years ago 
B wave renova ne 二 
E LICENSE doc 3 years aoo 
E README rst. README update fci S months ago 


4-2-3 
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€ 使 用 pip 安装 
pip install robotframework-appiumlibrary 


€ ”使 用 setup.py 安装 


git clone https://github.com/jollychang/robotframework-appiumlibrary.git 
cd robotframework-appiumlibrary 
python setup.py install 


4.2.1 Open Application 
在 AppiumLibrary Æ}, Open Application 关键 字 用 来 打开 一 个 待 测试 移动 APP. 


【示例 】 连 接 本 机 已 经 打开 的 appium 服务 端 ， 打 开 一 个 待 测试 的 安 卓 APP， 指 定 测试 平 
台 为 Android， 测 试 的 手机 deviceName 为 98YFBP522VSU， 需 要 打开 的 APP 路 径 为 
C:/Users/yongqing/Desktop/app-debug.apk, APP 的 包 名 为 com.example.calculator， 启 动 的 
appActivity 为 MainActivity。 


Open Application http: //localhost: 4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 


app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 


执行 结果 如 图 4-2-4 所 示 。 


- Ld AppiumLitxary .Open Application http://localhost 4723/wd/hub, platformName=Android, platformVersion=22, deviceName-98YFBP522VSU 
‘app=C-/Users/yongging/Desktop/app-debug apk. appPackage=com example calculator, appActivity=MainActivity 


Documentation: Opens a new application to given Appium server. 
Start / End / Elapsed: 20170415 22:42:00 863 / 20170415 22:42:14.939 / 00:00:14.076 
4-2-4 
执行 完成 后 ， 在 手机 上 会 自动 打开 指定 的 APP， 如 图 4-2-5 所 示 。 


© ule wilt + am 95 


图 4-2-5 


Appium 端 会 打印 如 下 运行 日 志 : 


> info: Found device 98YFBP522VSU 

> info: [debug] Setting device id to 98YFBP522VSU 

> info: [debug] Waiting for device to be ready and to respond to shell commands 
(timeout = 5) 


> info: [debug] executing cmd: E:\android—sdk—windows\platform-tools\adb.exe -s 
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98YFBP522VSU wait-for-device 

> info: [debug] executing cmd: E:\android-sdk—windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "echo 'ready'" 

» info: [debug] Starting logcat capture 

» info: [debug] Getting device API level 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "getprop ro.build.version.sdk" 

» info: [debug] Device is at API Level 22 

» info: Device API level is: 22 

» info: [debug] Extracting strings for language: default 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "getprop persist.sys.language" 

» info: [debug] Current device persist.sys.language: 

» info: [debug] java -jar 

"FE: \selenium\appium\node_modules\appium\node_modules\appium-adb\jars\appium_a 
pk tools.jar" "stringsFromApk" "C:\Users\yongqing\Desktop\app-debug.apk" 

"C: \Users\yongqing\AppData\Local\Temp\com.example.calculator" 

> info: [debug] Reading strings from converted strings.json 

> info: [debug] Setting language to default 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU push 

"C:\\Users\\yongqing\ \AppData\\Local\\Temp\\com.example.calculator\\strings.j 
son" /data/local/tmp 

> info: [debug] Checking whether aapt is present 

> info: [debug] Using aapt from 
E:\android-sdk-windows\build-tools\24.0.1\aapt.exe 

> info: [debug] Retrieving process from manifest. 

> info: [debug] executing cmd: 
E:\android-sdk-windows\build-tools\24.0.1\aapt.exe dump xmltree 
c:\Users\yongqing\Desktop\app-debug.apk AndroidManifest.xml 

> info: [debug] Set app process to: com.example.calculator 

> info: [debug] Not uninstalling app since server not started with --full-reset 
> info: [debug] Checking app cert for C:\Users\yongqing\Desktop\app-debug.apk. 
> info: [debug] executing cmd: java -jar 
F:\selenium\appium\node_modules\appium\node_modules\appium-adb\jars\verify.ja 
r C:\Users\yongqing\Desktop\app-debug.apk 

> info: [debug] App already signed. 

> info: [debug] Zip-aligning C:\Users\yongqing\Desktop\app-debug.apk 
> info: [debug] Checking whether zipalign is present 
> info: [debug] Using zipalign from 
E:\android-sdk-windows\build-tools\24.0.1\zipalign.exe 
> info: [debug] Zip-aligning apk. 
> info: [debug] executing cmd: 
E:\android-sdk—windows\build-tools\24.0.1\zipalign.exe -f 4 
C:\Users\yongqing\Desktop\app-debug.apk 
C:\Users\ yongqing\AppData\Local\Temp\117315-3596-1p91thv\appium. tmp 
> info: [debug] MD5 for app is 6192e720723dd8700a640a5fb7c59cd2 
> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "ls /data/local/tmp/6192e720723dd8700a640a5fb7c59cd2.apk" 
> info: [debug] Getting install status for com.example.calculator 
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> info: [debug] Getting device API level 

> info: [debug] executing cmd: E:Nandroid-sdk-windowsNplatform-toolsNadb.exe -s 
98YFBP522VSU shell "getprop ro.build.version.sdk" 

» info: [debug] Device is at API Level 22 

> info: [debug] executing cmd: E:\android-sdk—-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "pm list packages -3 com.example.calculator" 

» info: [debug] App is installed 

» info: App is already installed, resetting app 

» info: [debug] Running fast reset (stop and clear) 

> info: [debug] executing cmd: E:\android-sdk—-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "am force-stop com.example.calculator" 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "pm clear com.example.calculator" 

» info: [debug] Forwarding system:4724 to device:4724 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU forward tcp:4724 tcp:4724 

» info: [debug] Pushing appium bootstrap to device... 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU push 
"F:\\selenium\\appium\\node_modules\\appium\\build\\android_bootstrap\\Appium 
Bootstrap.jar" /data/local/tmp/ 

> info: [debug] Pushing settings apk to device... 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU install 
"F:\selenium\appium\node_modules\appium\build\settings_apk\settings_apk-debug 
.apk" 
» info: [debug] Pushing unlock helper app to device... 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU install 
"F:\selenium\appium\node_modules\appium\build\unlock_apk\unlock_apk-debug.apk 


> info: Starting App 

> info: [debug] Attempting to kill all 'uiautomator' processes 

> info: [debug] Getting all processes with 'uiautomator' 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "ps 'uiautomator'" 

» info: [debug] No matching processes found 

» info: [debug] Running bootstrap 

> info: [debug] spawning: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell uiautomator runtest AppiumBootstrap.jar -c 
io.appium.android.bootstrap.Bootstrap -e pkg com.example.calculator -e 
disableAndroidWatchers false 

> info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: numtests=1 

» info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: stream- 

» info: [debug] [UIAUTOMATOR STDOUT] io.appium.android.bootstrap.Bootstrap: 

» info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: 
id-UiAutomatorTestRunner 

» info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: test-testRunServer 
» info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: 
class=io.appium.android.bootstrap.Bootstrap 
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android. 


> info: 


> info: 
> info: 


> info: 
> info: 


com.example.ca 


> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
> info: [debug 
{"cmd":"action 
> info: [debug 
> info: [debug 
> info: [debug] 
> info: [debug] 
> info: [debug 
> info: [debug 
> info: [debug 
{"cmd": "action" 
> info: [debug 
> info: [debug 
> info: [debug 
["status" 

» info: [debug 
» info: [debug 
» info: [debug 
[("cmd": "action" 
t":false]) 

» info: [debug 
» info: [debug 

» info: [debug 

» info: [debug 
» info: [debug 

» info: [debug 
» info: [debug 


debug 


debug 


debug 


UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS: current=1 
UIAUTOMATOR STDOUT] INSTRUMENTATION STATUS CODE: 1 

BOOTSTRAP debug] Socket opened on port 4724 

BOOTSTRAP debug] Appium Socket Server Ready 

BOOTSTRAP debug] Loading json... 

BOOTSTRAP debug] json loading complete. 

Waking up device if it's not alive 

Pushing command to appium work queue: ["wake",{}] 

BOOTSTRAP debug] Registered crash watchers. 

BOOTSTRAP debug] Client connected 

BOOTSTRAP debug] Got data from client: 

,"action": "wake", "params": {}} 

BOOTSTRAP debug] Got command of type ACTION 

BOOTSTRAP debug] Got command action: wake 

[BOOTSTRAP] [debug] Returning result: {"status":0,"value":true} 
executing cmd: E:\android-sdk—windows\platform-tools\adb.exe -s 


98YFBP522VSU shell "dumpsys window" 


Screen already unlocked, continuing. 

Pushing command to appium work queue: ["getDataDir", {}] 
BOOTSTRAP debug] Got data from client: 
","action":"getDataDir","params":()) 

BOOTSTRAP debug] Got command of type ACTION 
BOOTSTRAP debug] Got command action: getDataDir 
BOOTSTRAP debug] Returning result: 


":0,"value":"\/data\/local\/tmp"} 


dataDir set to: /data/local/tmp 
Pushing command to appium work queue: 


["compressedLayoutHierarchy", ("compressLayout":false]] 


BOOTSTRAP debug] Got data from client: 
","action": "compressedLayoutHierarchy", "params": {"compressLayou 


BOOTSTRAP debug] Got command of type ACTION 

[BOOTSTRAP] [debug] Got command action: compressedLayoutHierarchy 
[BOOTSTRAP] [debug] Returning result: {"status":0,"value":false} 
Getting device API level 

executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 


98YFBP522VSU shell "getprop ro.build.version.sdk" 


Device is at API Level 22 
executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 


98YFBP522VSU shell "am start -S -a android.intent.action.MAIN -c 
intent.category.LAUNCHER -f 0x10200000 -n 
lculator/MainActivity" 


We tried to start an activity that doesn't exist, retrying with . 


prepended to activity 
[debug] Getting device API level 


executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 


98YFBP522VSU shell "getprop ro.build.version.sdk" 
[debug] Device is at API Level 22 


executing cmd: E:\android-sdk—windows\platform-tools\adb.exe -s 


98YFBP522VSU shell "am start -S -a android.intent.action.MAIN -c 
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android.intent.category.LAUNCHER -f 0x10200000 -n 
com.example.calculator/.MainActivity" 

» info: [debug] Waiting for pkg "com.example.calculator" and activity 
"MainActivity" to be focused 

» info: [debug] Getting focused package and activity 

> info: [debug] executing cmd: E:Nandroid-sdk-windowsNplatform-toolsNadb.exe -s 
98YFBP522VSU shell "dumpsys window windows" 

> info: [debug] executing cmd: E:\android-sdk-windows\platform-tools\adb.exe -s 
98YFBP522VSU shell "getprop ro.build.version.release" 

» info: [debug] Device is at release version 5.1 

» info: [debug] Device launched! Ready for commands 

» info: [debug] Setting command timeout to the default of 60 secs 

» info: [debug] Appium session started with sessionId 
090a2542-63ee-4e1b-912f-32d67922d49e 

» info: «-- POST /wd/hub/session 303 13662.949 ms - 74 

> info: --» GET /wd/hub/session/090a2542-63ee-4e1b-912f-32d67922d49e {} 

» info: [debug] Responding to client with success: 

{"status , "value": {"platform": "LINUX", "browserName": "Android", "platformVers 
ion":"5.1", "webStorageEnabled": false, "takesScreenshot":true, "javascriptEnable 
a": true, "databaseEnabled": false, "networkConnectionEnabled": true, "locationCont 
extEnabled": false, "warnings": {},"desired": {"deviceName" 98YFBP522VSU", "app": 
"C: /Users/yongqing/Desktop/app-debug.apk", "platformVersion":"22 appPackage" 
:"Com.example.calculator","platformName":"Android","appActivity":"MainActivit 
y"),"deviceName":"98YFBP522VSU" , "app" : "C: /Users/yongging/Desktop/app-debug.ap 
k appPackage":"com.example.calculator", "platformName": "Android", "appActivit 
y MainActivity"}, "sessionId": "090a2542-63ee-4elb-912f-32d67922d49e"} 

> info: «-- GET /wd/hub/session/090a2542-63ee-4e1b-912f-32d67922d49e 200 2.395 
ms - 686 

{"status" "value": {"platform": "LINUX", "browserName": "Android", "platformVers 
"5.1", "webStorageEnabled": false, "takesScreenshot": true, "javascriptEnable 
da": true, "databaseEnabled": false, "networkConnectionEnabled": true, "locationCont 
extEnabled": false, "warnings": {},"desired": {"deviceName":"98YFBP522VSU", "app": 
: /Users/yongqing/Desktop/app-debug.apk" 
:"com.example.calculator", "platformName 
y"),"deviceName 98YFBP522VSU" , "app" : "C: /Users/yongging/Desktop/app-debug.ap 
k","appPackage":"com.example.calculator","platformName":"Android","appActivit 
y":"MainActivity"),"sessionId 090a2542-63ee-4e1b-912f-32d67922d49e") 


4.2.2 Input Text 和 Click Button 
Input Text 关键 字 一 般 用 来 给 输入 框 进行 输入 操作 ， 接 收 [locator | text] 两 个 参数 。 


【示例 1】 启 动 安 卓 手机 上 一 个 APP 的 MainActivity， 在 打开 Activity 进入 界面 后 ， 分 别 
向 两 个 EditText 输入 框 中 输入 “12”, 并 且 单 击 “计算 ”按钮 来 计算 输入 的 两 个 数字 的 乘积 。 


APP 的 界面 ， 提 供 了 两 个 输入 框 、 一 个 计算 按钮 (Button〉， 如 图 4-2-6 所 示 。 
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图 4-2-6 


在 写 这 个 自动 化 案例 前 , 我 们 可 以 使 用 安 卓 SDK 提供 的 Ui Automator Viewer 工具 来 进行 

这 个 界面 的 资源 定位 。 通 过 定位 ， 可 以 看 到 第 一 个 EditText 输入 框 的 resource-id 为 

“com.example.calculator:id/factorone” , class 为 “android.widget.EditText”、text 为 “请 输入 
数字 ”， 如 图 4-2-7 所 示 。 


4 (0) FrameLayout [0,0][720,1280] 
4 (0) LinearLayout [0,01720,1280] 
4 (0) FrameLayout [0,50][720,1280] 
4 (0) LinearLayout [0,50][720,1280] 
(0) EditText 请 输入 数字 [0,50][720,141] 
(1) TextViewSRLX [0.141][720.179] 
(2) EdiText 请 给 入 数字 [0,179]720,270] 
(3) Button:it [0.270][720,366] 
(4) View [0,0](720,50] 


Node Detail 
index 

text 
resource-id 


class 


package com.example.calculator 


content-desc 

checkable false 
checked false 
clickable 

enabled 

focusable 

focused 

scrollable 

long-clickable 

password 


4-2-7 


第 二 个 EditText 输入 框 的 resource-id Jy “com.example.calculator:id/factortwo” . class 为 
“android.widget.EditText” ~ text 为 “请 输入 数字 ”， 如 图 4-2-8 所 示 。 
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< (0) FrameLayout [0,01[720,1280} 
4 (0) LinearLayout [0,0][720,1280] 
4 (0) FrameLayout [0,50]/720,1280] 
4 (0) LinearLayout [0,50][720,1280] 

(0) EditText3SE A 22> [0.501720.141] 
(4) TextView&EA [0.141][720,179] 
(2) EditTex 调 输入 数字 [0,179]1720,270) 
(3) Button: [0,270][720,366] 

(1) View [0,01/720,50] 


Node Detail 
index 

text 

resource-id 

class 

package com.example.calculator 
content-desc 

checkable false 

checked false 

clickable true 

enabled true 

focusable true 

focused false 

scrollable false 

long-clickable true 

password false 


4-2-8 


Button 按钮 的 resource-id Jy“ com.example.calculator:id/commit”. class 为 "android.widgetButton ”, 
text 为 “计算 ”， 如 图 4-2-9 所 示 。 


< (0) FrameLayout [0,0][720,1280] 
4 (0) LinearLayout (0,0]720.1280] 
4 (0) FrameLayout [0,50][720,1280] 
4 (0) LinearLayout [0,50][720,1280] 
(0) EditText RARE [0,50][720,141] 
(1) TextViewsRLA [0,141]1720,179] 
(2) EditText 请 给 入 数字 [0.1791[720.270] 


(3) Buttons [0,27011720,3661| 
(2) View [0,0][720,50] 
Node Detail 
index 3 
class get eutton 
package com.example.calculator 
content-desc 
checkable false 
checked false 
clickable true 
enabled true 
focusable true 
focused false 
scrollable false 
long-clickable false 
password false. 
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Click Button 关键 字 用 来 模拟 单 击 APP 上 的 一 个 button 按钮 ， 该 关键 字 接收 一 个 参数 


[index or name ] 。 


Open Application http://localhost:4723/wd/hub  platformName=Android 
platformVersion-22 deviceName-98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 

Input Text id=com.example.calculator:id/factorone 12 

Input Text id=com.example.calculator:id/factortwo 12 

Click Button 计算 


执行 结果 如 图 4-2-10 所 示 。 


= CGD somite Open Application http //localhost 4723/wd/hub, platformName=Android, platformVersion=22, deviceName=98YFBP522VSU, 
a rs/ yongging/Desktop/app-debug. apk. appPackage-com.example calculator, appActivity-MainActivity 
Documentation: Opens a new application to given Applum server. 
Start/End/Elapsed: — 20170429 16:07:13.080 / 20170429 16.07 28.442 / 00:00:15.362 
- AppiumLibxary .Input Text id=factorone, 12 
Documentation: Types the given "text into text field identified by "locator 
Start/End/Elapsed: — 20170429 16:07:28.444 /20170429 16:07:33 265 /00:00:04.821 
16:07:28.446 — INFO Typing text 12’ into text field ‘id=factorone’ 
= [33D Appumuibrary .Input Text id=factortwo, 12 
Documentation: Types the given ‘text’ into text field identified by "locator 
Start/End/Elapsed: — 20170429 16:07:33.266 /20170429 16:07:38 573 / 00:00:05.307 
16:07:33.288 — INFO Typing text ‘12 into text field ‘id=factortwo’ 
- CSLI Appamuiteary .Click Button it 
Documentation: Click button 
Start/End/Elapsed: — 20170429 16:07:38.583 /20170429 16:07:39.683 / 00:00:01.100 
16:07:39. 164 INFO “计算 ' 
16:07:39.235 |NFO Clicking element “计算 


图 4-2-10 


可 以 看 到 已 经 执行 成 功 。 上 面 通过 resource-id 的 方式 来 定位 EditText 输入 框 ， 并 且 通 过 
name 的 方式 来 定位 button 按钮 。 

下 面 使 用 另 一 种 方式 ， 即 通过 name 的 方式 来 定位 EditText 输入 框 、 通 过 index 的 方式 来 
单 击 button 按钮 。 


Open Application http://localhost:4723/wd/hub platformName-Android 
platformVersion-22 deviceName-98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 


appPackage-com.example.calculator 
Input Text name= 请 输入 数字 12 
Input Text name= 请 输入 数字 14 
Click Button index=0 


执行 结果 如 图 4-2-11 所 示 。 
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= AppiumLibrary Open Application http llocalhost 4723/wd/hub. platformName=Android, platformVersion-22. deviceName-98YFBP522VSU, 
Sers/yongqing/Desktop/app-debug.apk. appPackage=com example calculator. appActivity=MainActivity 
Documentation: Opens a new application to given Appium server 
Start/End/Elapsed: — 2017050100:41:43.641/20170501 00:41:55.900 /00:00:12.259 
= AppiumLibrary .Input Text name= 请 输入 数字 . 12 
Documentation: Types the given "text into text field identified by "locator 
Start/End/Elapsed: 20170501 00:41:55.901 / 20170501 00:42:01 244 / 00:00:05.343 
00:41:55,902 INFO Typing text ‘12’ into text field “nane= 请 输入 数字 
=  AppumLitxary .Input Text name= 请 输入 数字 . 14 
Documentation: Types the given "text into text field identified by "locator 
Start/End/Elapsed: — 20170501 00:42:01.245 / 20170501 00:42:06.597 / 00:00:05.352 
00:42:01,246 INFO Typing text ‘14’ into text field ‘nane= 请 输入 数字 
= (SLE Appumtitrary .Click Button ndex=0 
Documentation: Click button 
Start/End/Elapsed: ^ 2017050100:42:06.597 /20170501 00:42:07 635 / 00:00:01.038 
00:42:07, 261 INFO Clicking element /计算 ' 


00:42:07.634 INFO = elenents:"[Cappius. webdriver. webelement. FebElement (sessi on=“Ofet746b-G02£-49£3-9949-cedfa547bd38°, elementz^4"))]^ 
index: “0” 
tlenent: Cappium webdriver webelenent WebElement (session-"Ofe4T45b-802£-49£3-9949- cedfdSATbi38", element="4")> 


图 4-2-11 


在 通过 index 的 方式 来 单 击 button 按钮 的 时 候 , 注意 index 的 取 值 不 要 和 通过 Ui Automator 
Viewer 工具 看 到 的 index 混淆 。 先 看 一 段 AppiumLibrary 库 的 源码 ， 在 这 里 选取 了 源码 中 的 三 
个 函数 。 从 如 下 三 个 函数 中 可 以 看 到 click button 关键 字 支 持 name 和 index 两 种 方式 来 定位 一 
个 button。 在 使 用 index 的 时 候 ,是 根据 class_name, 即 通过 android.widgetButton 这 个 class_name 
来 找 出 当前 界面 中 有 几 个 button 按钮 (源码 中 通过 elements = 
self. find elements by class name(class name)?K F 4R, 4 JL^* button 按钮 ， 就 会 返回 几 个 
element), 然后 每 个 button 按钮 按照 index 的 方式 来 取出 (源码 中 通过 element = elements[index] 
来 得 到 具体 的 一 个 button 按钮 ) 。 

AppiumLibrary 库 函 数 1: 

def click_button(self, index_or_name): 

s". DIigk titted "e^ 
platform class dict = ('ios': 'UIAButton', 
'android': 'android.widget.Button') 


if self. is support platform( platform class dict): 
class name = self. get class( platform class dict) 


Self. click element by class name(class name, index or name) 
AppiumLibrary 库 函 数 2: 


def _click_element_by class_name(self, class_name, index_or_name): 
element = self. find element by class name(class name, index or name) 
self. info("Clicking element '$s'." $ element.text) 
try: 
element.click() 


except Exception as e: 
raise 'Cannot click the $s element "$s"' % (class name, index or name) 


AppiumLibrary 库 函 数 3: 


def _find_element_by class_name(self, class_name, index_or_name): 


elements = self. find elements by class name(class name) 
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print 'elements:"$s"' $ elements 


if self. is index(index or name): 
try: 
index = int(index or name.split('-')[-1]) 
print 'index:"$s"' $ index 
element — elements[index] 
print 'element:' , element 
except (IndexError, TypeError): 
raise 'Cannot find the element with index "$s"' $ index or name 
else: 
found - False 
for element in elements: 
self. info("'$5'." % element.text) 


if element.text == index or name: 
found - True 
break 


if not found: 
raise 'Cannot find the element with name "$s"' $ index or name 


在 界面 中 放 入 两 个 button 按钮 ， 一 个 button 按钮 是 “计算 ”按钮 ， 一 个 button 按钮 是 “ 取 
消 ” 按 钮 ， 如 图 4-2-12 所 示 。 


00:28 人 中 © uils lS + amm 100 
12 
乘 以 
14 
计算 
取消 
图 4-2-12 


在 执行 时 ， 通 过 elements = self. find elements by class name(class name) 得 到 所 有 的 
button 按钮 后 ， 再 用 print 'elements:"%s" % elements 打印 出 获取 到 的 elements， 也 就 是 所 有 的 
button。 从 如 下 的 输出 结果 可 以 看 到 elements 会 存放 在 一 个 列表 中 ， 该 列表 中 共有 两 个 元 素 ， 
代表 取 到 了 两 个 button 按钮 : 


elements:"[<appium.webdriver.webelement .WebElement 
(session="8e85c12f-2243-4b82-abfc-d091fddbed8b", element="4")>, 
«appium.webdriver.webelement.WebElement 
(session-"8e85c12f-2243-4b82-abfc-d091fddbed8b", element-"5")»]" 


“index 为 0 时 , 会 取 到 第 一 个 按钮 ， 也 就 是 “计算 ”这 个 button 按钮 : “4 index 为 1 时 ， 
会 取 到 第 二 个 按钮 ， 也 就 是 “取消 ”这 个 button 按钮 ; 当 index 超过 1 后 ， 就 会 报错 ， 此 时 源 
码 中 会 通过 raise "Cannot find the element with index "%s"' % index or name 来 抛 出 一 个 异常 ， 
告诉 使 用 者 , 不 能 通过 当前 的 index 获取 到 element( 也 就 是 此 时 无 法 获取 到 任何 button 按钮 + 
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【示例 2】 通 过 xpath 的 方式 定位 元 素 ， 这 里 依旧 以 上 面 的 APP 界面 为 示例 。 
用 xpath 的 方式 定位 第 一 个 EditText 输入 框 和 第 二 个 EditText 输入 框 ， 示 例如 下 : 


Open Application http: //localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 


app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 
Input Text xpath-//android.widget.EditText[1] 12 
Input Text xpath-//android.widget.EditText[2] 14 
Click Button 计算 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase005 

20170510 13:45:07.381 : INFO : Typing text '12' into text field 
'xpath-//android.widget.EditText[1]" 

20170510 13:45:07.381 : INFO : msg:find xpath=//android.widget.EditText [1] 
20170510 13:45:07.381 : INFO : prefix: xpath 

20170510 13:45:07.397 : INFO : criteria: //android.widget.EditText[1] 
20170510 13:45:10.462 : INFO : elements: 

[<appium.webdriver.webelement .WebElement 
(session-"ec48b38a-9cbe-457d-94a0-dec662d3f9cb", element="1") >] 

20170510 13:45:15.313 : INFO : Typing text '14' into text field 
'xpath-//android.widget.EditText [2]" 

20170510 13:45:15.313 : INFO : msg:find xpath-//android.widget.EditText[2] 
20170510 13:45:15.313 : INFO : prefix: xpath 

20170510 13:45:15.313 : INFO : criteria: //android.widget.EditText [2] 
20170510 13:45:15.906 : INFO : elements: 
[«appium.webdriver.webelement.WebElement 
(session-"ec48b38a-9cbe-457d-94a0-dec662d3f9cb", element-"2")»5] 

20170510 13:45:21.307 : INFO : ' 计 算 '. 

20170510 13:45:21.385 : INFO : Clicking element 'it£€'. 

Ending test: | RobotFrameworkTestl.TestSuite5.TestCase005 


从 上 面 的 执行 结果 看 ， 通 过 xpath-//android.widget.EditText[1] 定位 到 了 第 一 个 输入 框 ， 
通过 xpath-//android.widget.EditText[2] 定位 到 了 第 二 个 输入 框 。 
【示例 3】 通 过 accessibility id 的 方式 定位 元 素 。accessibility id 对 应 到 安 卓 APP 后 ， 其 
对 应 的 属性 为 content-desc， 这 里 依旧 以 上 面 的 APP 界面 为 示例 ， 但 是 我 们 对 第 一 个 EditText 
输入 框 加 入 了 content-desc 属性 ， 如 图 4-2-13 所 示 。 
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Open Application http://localhost:4723/wd/hub platformName-Android 
platformVersion-22 deviceName-98YFBP522VSU 
app-C:/Users/yongding/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 

Input Text accessibility id= 输 入 框 23 

Input Text id-com.example.calculator:id/factortwo 12 

Click Button 计算 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase006 

20170510 14:23:09.735 : INFO: Typing text '23' into text field 'accessibility id= 
输入 框 ' 

20170510 14:23:09.735 : INFO : msg:find accessibility id= 输 入 框 

20170510 14:23:16.573 : INFO : Typing text '12' into text field 
'id-com.example.calculator:id/factortwo" 

20170510 14:23:16.573 : INFO : msg:find id-com.example.calculator:id/factortwo 
20170510 14:23:22.799 : INFO : "计算 '. 

20170510 14:23:22.901 : INFO : Clicking element ' 计 算 ' . 

Ending test: ^ RobotFrameworkTestl.TestSuite5.TestCase006 


从 执行 结果 看 ， 通 过 “accessibility id= 输 入 框 ” 也 可 以 定位 到 EditText 输入 框 。 


4.2.3 Clear Text 


Clear Text 关键 字 用 来 清除 输入 框 的 数据 ， 接 收 一 个 参数 [ locator ]， 这 里 的 locator 指 的 就 
是 界面 元 素 的 定位 方式 。 
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【示例 1] Clear Text 清除 输入 框 数 据 时 ， 采 用 resource-id 的 方式 来 定位 输入 框 。 这 里 依 
旧 采 用 上 面 使 用 的 APP 界面 来 做 操作 示例 ， 将 输入 的 数字 12 通过 Clear Text id=com.example. 
calculator:id/factorone 来 清除 。 


Open Application http: //localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C : /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Input Text name= 请 输入 数字 12 

Input Text name= 请 输入 数字 14 

Click Button index=1 


Clear Text id=com.example.calculator:id/factorone 


执行 结果 如 图 4-2-14 所 示 。 


devesName=S8YFBPS22VSU 


Aor, platomversio 
app feor vonyang/Deuifop'aco deoug apt. zoeFaciage-eom oampe 5culaor sppActity Mandy 
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start End Elapeec: 0300347 
Documentation: fel dented by Yocar 
Start End / Elapsed! 2232 302.30958 /00:0007.310 
nmam INFO) Typing tnt IZ ao tent iU "ome DER" 
-CET pm input Text rarest 14 
Documentation: Types ha gan tart ink tol entiod by ocatr 
Start /End/ Elapsed: 20170802 73:02 30,209 20179802 23023534110000 05 382 
23.02.30. 980 INFO Tine te Late text. field nemesis” 
- (ERLE) Aosamtier Click Button indet 
Documentation: Click button 
Start/End/Elapsod: 2017050220026 342/21 


2502 23 62:40 120/00:0003.773. 


23 0:30.02 
masus cot sciet NT EAEE TO deel BAEC, dann tT), Gw edi var shao YAI nent (seien nl 
Maren. (gps vehrive vedere mat Gessi mae EIDA OALA Getit, dementa "3") 
= CALLE Mrmr .Cleor Text decor: eanpk cakuliordfactcroe 
Documentation: 


Start/End / Elapsed: 42550000006 410 
20:08:40,121 


图 4-2-14 


【示例 2] Clear Text 清除 输入 框 数据 时 ， 采 用 xpath 的 方式 来 定位 输入 框 ， 这 里 依旧 采用 
上 面 使 用 的 APP 界面 来 做 操作 示例 ， 将 输入 的 数字 12 通过 Clear Text xpath=//android.widget. 
EditText[1] 来 清除 掉 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Input Text name= 请 输入 数字 12 

Input Text name= 请 输入 数字 5 

Click Button index=1 

Clear Text xpath=//android.widget.EditText [1] 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase004 

20170510 13:53:54.517 : INFO : Typing text '12' into text field 'name= 请 输入 数 
€ 

20170510 13:53:54.517 : INFO : msg:find name= 请 输入 数字 

20170510 13:53:54.517 : INFO : prefix: name 
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20170510 13:53:54.517 : INFO : criteria: 请 输入 数字 

20170510 13:53:56.421 : INFO : elements: 
[<appium.webdriver.webelement .WebElement 
(session-"b5daf778-7f£94-495c-971d-77b0ad5f52ed", element="1")>, 
<appium.webdriver.webelement .WebElement 
(session="b5daf778-7f94-495c-971d-77b0ad5f52ed", element="2") >] 
20170510 13:54:01.366 : INFO : Typing text '5' into text field 'name= 请 输入 数字 
20170510 13:54:01.381 : INFO : msg:find name= 请 输入 数字 

20170510 13:54:01.381 : INFO : prefix: name 

20170510 13:54:01.381 : INFO : criteria: 请 输入 数字 

20170510 13:54:01.927 : INFO : elements: 
[<appium.webdriver.webelement .WebElement 
(session-"b5daf778-7£94-495c-971d-77b0ad5f52ed", element="3") >] 
20170510 13:54:07.416 : INFO : Clicking element ' 取 消 '. 

20170510 13:54:10.552 : INFO : Clear text field 
'xpath-//android.widget.EditText[1]" 

20170510 13:54:10.552 : INFO : msg:find xpath=//android.widget.EditText [1] 
20170510 13:54:10.552 : INFO : prefix: xpath 

20170510 13:54:10.552 : INFO : criteria: //android.widget.EditText[1] 
20170510 13:54:10.848 : INFO : elements: 
[<appium.webdriver.webelement .WebElement 
(session="b5daf778-7£94-495c-971d-77b0ad5£52ed", element="6") >] 
20170510 13:54:10.848 : INFO : execute element.clear by 
<appium.webdriver .webelement .WebElement 
(session="b5daf778-7£94-495c-971d-77b0ad5£52ed", element="6") > 

Ending test: RobotFrameworkTest1.TestSuite5.TestCase004 


从 上 面 的 执行 日 志 看 ， 通 过 xpath=//android.widget.EditText[1] 成 功 定位 到 了 输入 框 ， 并 且 
执行 Clear Text 关键 字 成 功 。 


4.2.4 Click Element 


Click Element 关键 字 用 来 模拟 单 击 APP 界面 上 的 一 个 元 素 ， 接收 一 个 参数 [ locator ] ， 
里 的 locator 指 的 是 界面 元 素 的 定位 方式 。 


【示例 】 使 用 Click Element 关键 字 来 模拟 单 击 一 个 button 按钮 ， 这 里 locator 使 用 name 
的 方式 来 定位 需要 单 击 的 元 素 ， 依 旧 采 用 上 面 使 用 的 APP 界面 来 做 操作 示例 。 


Open Application http: //localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Input Text accessibility id= 输 入 框 28 

Input Text id-com.example.calculator:id/factortwo 12 

Click Element name=il# 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase007 


lm 
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20170510 15:13:18.868 : INFO: Typing text '23' into text field 'accessibility id= 
输入 框 " 

20170510 15:13:18.868 : INFO : msg:find accessibility id= 输 入 框 

20170510 15:13:25.718 : INFO : msg:find id=com.example.calculator:id/factortwo 
20170510 15:13:31.077 : INFO : Clicking element 'name= 计 算 ' . 

20170510 15:13:31.077 : INFO : msg:find name= 计 算 

20170510 15:13:31.704 : INFO : elements: 

[<appium.webdriver.webelement .WebElement 
(session-"3b92f067-4ddd-4dc5-90eb-c6915eb8e364", element="3") >] 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase007 


从 执行 结果 可 以 看 到 ， 通 过 Click Element 关键 字 也 可 以 模拟 单 击 一 个 button 按钮 。 


4.2.5 Click A Point 


Click A Point 关键 字 用 来 模拟 单 击 APP 界面 上 的 一 个 点 , 接收 [x70 | y=0 | duration=100 ] 
三 个 参数 ，x 和 y 代表 的 是 点 的 坐标 位 置 ，duration 代表 的 是 单 击 持续 的 时 长 。 这 三 个 参数 如 
果 没 有 传 入 ， 就 会 默认 x=0、y=0、duration=100。 


【示例 】 这 里 依旧 采用 上 面 使 用 的 APP 界面 来 做 操作 示例 ， 使 用 Click A Point 关键 字 来 
模拟 单 击 一 个 button 按钮 ， 输 入 button 按钮 所 在 的 坐标 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C:/Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Input Text accessibility id= 输 入 框 23 

Input Text id=com.example.calculator:id/factortwo 12 

Click A Point 370 339 1000 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase008 

20170510 15:32:25.243 : INFO: Typing text '23' into text field 'accessibility id= 
输入 框 " 

20170510 15:32:25.243 : INFO : msg:find accessibility id= 输 入 框 

20170510 15:32:32.005 : INFO : Typing text '12' into text field 
'id-com.example.calculator:id/factortwo" 

20170510 15:32:32.006 : INFO : msg:find id-com.example.calculator:id/factortwo 
20170510 15:32:37.282 : INFO : Clicking on a point (370,339). 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase008 


从 执行 结果 看 到 ， 还 可 以 通过 Click A Point 关键 字模 拟 单 击 一 个 button 按钮 。 


4.2.6 Click Element At Coordinates 


Click Element At Coordinates 关键 字 通 过 一 个 具体 的 坐标 点 来 模拟 单 击 一 个 Element, 接收 
[ coordinate X | coordinate Y ] 两 个 参数 。 


【示例 】 这 里 依旧 采用 上 面 使 用 的 APP 界面 来 做 操作 示例 ， 使 用 Click Element At 
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Coordinates 关键 字 来 模拟 单 击 一 个 button 按钮 ， 输 入 button 按钮 所 在 的 坐标 。 


Open Application http: //localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C : /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Input Text accessibility id= MA#E 23 

Input Text id=com.example.calculator:id/factortwo 12 

Click Element At Coordinates 370: 339 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase009 
2017051015:43:00.061: INFO: Typingtext '23' intotext field 'accessibility id- 
输入 框 ' 

20170510 15:43:00.062 : INFO : msg:find accessibility id= 输 入 框 

20170510 15:43:06.198 : INFO : Typing text '12' into text field 
'id-com.example.calculator:id/factortwo" 

20170510 15:43:06.198 : INFO : msg:find id-com.example.calculator:id/factortwo 
20170510 15:43:11.649 : INFO : Pressing at (370, 339). 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase009 


从 执行 结果 看 到 ， 使 用 Click Element At Coordinates 关键 字 可 以 成 功 模拟 一 个 单 击 按钮 的 
操作 。 


4.2.7 Get Element Location 


Get Element Location 关键 字 用 来 获取 一 个 Element 的 Location 位 置 ， 接 收 一 个 参数 
[ locator ] 。 


【示例 】 使 用 Get Element Location 来 获取 一 个 EditText 输入 框 的 Location CE, fE 
这 里 依旧 采用 上 面 使 用 的 APP 界面 来 做 操作 示例 。 


Open Application http://localhost:4723/wd/hub platformName-Android 
platformVersion-22 deviceName-98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 
${Location} Get Element Location id-com.example.calculator:id/factorone 
log ${Location} 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase010 

20170510 15:56:05.348 : INFO : msg:find id=com.example.calculator:id/factorone 
20170510 15:56:06.929 : INFO : Element 'id=com.example.calculator:id/factorone' 
location: ("ys 50, "ss 0) 

20170510 15:56:06.930 : INFO : ${Location} = ('y': 50, 'x': 0) 

20170510 15:56:06.932 : INFO : [('y': 50, "x": 0) 

Ending test: RobotFrameworkTest1.TestSuite5.TestCase010 


从 执行 结果 可 以 看 到 ， 获 取 到 的 Location 结果 为 {'y': 50, 'x': 01. 
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4.2.8 Get Current Context 
Get Current Context 关键 字 用 于 获取 当前 的 上 下 文 ， 不 需要 接收 任何 参数 。 


【示例 】 使 用 Get Current Context 来 获取 当前 APP 的 上 下 文 , 在 这 里 依旧 采用 上 面 使 用 的 
APP 来 做 操作 示例 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 
${Context} Get Current Context 


log ${Context} 
执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase011 
20170510 16:02:17.889 : INFO : ${Context} = NATIVE APP 
20170510 16:02:17.891 : INFO : NATIVE APP 


Ending test: X RobotFrameworkTestl.TestSuite5.TestCase011 
从 执行 结果 可 以 看 到 ， 获 取 到 的 Context 结果 为 NATIVE_ APP。 


4.2.9 Get Contexts 
Get Contexts 关键 字 用 于 获取 当前 所 有 的 上 下 文 ， 不 需要 接收 任何 参数 。 


【示例 】 使 用 Get Contexts 来 获取 当前 APP 的 所 有 上 下 文 ， 在 这 里 依旧 采用 上 面 使 用 的 
APP 来 做 操作 示例 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app-C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

${Contexts} Get Contexts 

log ${Contexts} 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase012 
20170510 16:08:46.565 : INFO : [u'NATIVE APP'] 

20170510 16:08:46.565 : INFO : ${Contexts} = [u'NATIVE APP'] 
20170510 16:08:46.565 : INFO : [u'NATIVE APP'] 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase012 


从 执行 结果 看 ， 我 们 只 获取 到 了 一 个 Context， 这 是 因为 当前 APP 中 就 只 打开 了 一 个 


Context。 


4.2.10 Switch To Context 
Switch To Context 关键 字 用 来 在 多 个 Context 之 间 进 行 切换 ， 接 收 [ context name ] 一 个 参数 。 
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我 们 在 手机 端 经 常会 调用 到 HS 页 面 ， 并 且 会 在 页 面 中 做 切换 ，Switch To Context 就 可 以 
帮助 我 们 完成 页 面 的 切换 操作 。 通 过 上 面 讲 到 的 Get Contexts 关键 字 可 以 获取 到 所 有 的 
Context， 然 后 执行 Switch To Context 关键 字 就 可 以 直接 做 切换 了 。 


【示例 】 切 换 到 APP ff] NATIVE APP 这 个 Context 下 面 。 


4.2.11 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C:/Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

${Contexts} Get Contexts 

log ${Contexts} 

Switch To Context NATIVE APP 


Get Elements 


Get Elements 关键 字 用 来 获取 通过 某 个 locator 匹配 到 的 所 有 的 元 素 ， 接 收 [ locator | 
first_element only=False | fail_on_error=True ] 三 个 参数 ， 其 中 ， 当 first_element_only=True 时 ， 
只 会 返回 匹配 到 的 第 一 个 元 素 ; 当 fail on_error=True 时 ， 如 果 没有 获取 到 任何 元 素 ， 那 么 该 


关键 字 会 执行 失败 。 


【示例 】 使 用 Get Elements 关键 字 和 locator W class=android.widget Button 来 获取 匹配 到 
的 所 有 的 元 素 ， 在 这 里 依旧 采用 上 面 使 用 的 APP 来 做 操作 示例 。 


Open Application http: //localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app-C: /Users/yongging/Desktop/app-debug.apk 
appPackage-com.example.calculator  appActivity-MainActivity 
${Elements} Get Elements class=android.widget.Button 


log ${Elements} 
执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase013 

20170510 16:18:17.221 : INFO : msg:find class=android.widget.Button 
20170510 16:18:18.995 : INFO : ${Elements} = 

[<appium. webdriver.webelement .WebElement 
(session-"205dfa7e-1289-40de-a555-34880166ccfa", element="1")>, 
<appium.webdriver .webelement .WebElement 
(session-"205dfa7e-1289-40de-a555-34880166ccfa", elemen... 

20170510 16:18:18.995 : INFO : [«appium.webdriver.webelement.WebElement 
(session-"205dfa7e-1289-40de-a555-34880166ccfa", element-"1")», 
«appium.webdriver.webelement.WebElement 
(session-"205dfa7e-1289-40de-a555-34880166ccfa", element="2") >] 
Ending test: RobotFrameworkTestl.TestSuite5.TestCase013 


从 执行 结果 看 ， 根 据 class=android.widget Button 获取 到 了 两 个 元 素 。 


4.2.12 Get Element Attribute 
Get Element Attribute 关 键 字 用 来 获取 某 个 元 素 的 属性 值 , 接收 [locator | attribute] 两 个 参数 。 
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【示例 】 使 用 Get Element Attribute 关键 字 和 locator 为 class=android.widget.Button 来 获取 
name 属性 的 值 ， 在 这 里 依旧 采用 上 面 使 用 的 APP 来 做 操作 示例 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 
${Attribute} Get Element Attribute  class-android.widget.Buttonname 


log ${Attribute} 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite5.TestCase014 

20170510 16:43:35.268 : INFO : msg:find class-android.widget.Button 

20170510 16:43:36.897 : INFO : elements: 
[«appium.webdriver.webelement.WebElement 
(session-"fcbb5ef0-d97c-4127-8719-0e6ef14c2403", element="1")>, 
«appium.webdriver.webelement.WebElement 
(session-"fcbb5ef0-d97c-4127-8719-0e6ef14c2403", element="2") >] 

20170510 16:43:36.897 : INFO : CAUTION: 'class=android.widget.Button' matched 
2 elements - using the first element only 

20170510 16:43:36.949 : INFO : Element 'class=android.widget.Button' attribute 
'name' value 'it#' 

20170510 16:43:36.950 : INFO : ${Attribute} = 计算 

20170510 16:43:36.953 : INFO : 计算 


Ending test: RobotFrameworkTest1l.TestSuite5.TestCase014 


从 执行 结果 看 ， 获 取 到 的 name 属性 值 为 “计算 ”， 而 且 根 据 执行 日 志 可 知 使 用 
class-android.widget.Button 匹配 到 了 两 个 元 素 ， 当 匹配 到 了 多 个 元 素 时 默认 只 会 使 用 第 一 个 元 素 。 


4.2.13 Get Network Connection Status 和 Set Network Connection 
Status 


Get Network Connection Status 关键 字 用 来 获取 手机 的 网 络 连接 状态 。 在 获取 到 连接 状态 
后 ， 会 返回 不 同 的 数字 。 
Set Network Connection Status 关键 字 用 来 设置 手机 的 网 络 连接 状态 ， 如 表 4-2-1 所 示 。 


表 4-2-1 手机 网 络 连接 的 状态 码 


不 打开 任何 连接 
打开 飞行 模式 


只 打开 wif 网 络 
只 打开 数据 连接 
打开 所 有 的 网 络 连接 | 
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【示例 】 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C : /Users/yongqing/Desktop/app-—debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

${Attribute} Get Network Connection Status 

log ${Attribute} 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase015 
20170513 15:16:05.063 : INFO : ${Attribute} = 0 

20170513 15:16:05.063 : INFO : 0 

Ending test: RobotFrameworkTest1.TestSuite5.TestCase015 


从 执行 结果 看 ， 获 取 到 连接 状态 码 为 0， 说 明 没有 打开 任何 网 络 连 接 。 


4.2.14 Element Attribute Should Match 


Element Attribute Should Match 关键 字 用 来 判断 元 素 的 属性 值 是 否 和 预期 值 匹 配 ， 接 收 
[ locator | attr_ name | match_pattern | regexp=False ] 四 个 参数 。 当 通过 locator 识别 到 元 素 超过 1 
个 元 素 时 , 会 默认 选择 第 一 个 元 素 ; attr_name 参数 代表 所 选 元 素 的 属性 的 名 称 ; match pattern 
参数 代表 预期 匹配 值 ，regexp 代表 了 匹配 时 是 否 通 过 正则 表达 式 来 进行 匹配 。 


【示例 1】 使 用 Element Attribute Should Match 关键 字 来 判断 通过 locator 为 
id=com.example.calculator:id/factorone 和 attr name=name 获取 到 的 值 是 否 能 和 预期 值 匹配 。 在 
这 里 依旧 采用 上 面 使 用 的 APP 来 做 操作 示例 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C:/Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Element Attribute Should Match 
id=com.example.calculator:id/factorone name 输入 框 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase017 

20170513 15:48:54.838 : INFO : msg:find id=com.example.calculator:id/factorone 
20170513 15:48:54.839 : INFO : prefix: id 

20170513 15:48:54.840 : INFO : criteria: com.example.calculator:id/factorone 
20170513 15:48:56.622 : INFO : elements: 
[«appium.webdriver.webelement.WebElement 
(session-"6708d455-65b8-4af7-8d7c-ea86e7f039f3", element="1")>] 

20170513 15:48:56.745 : INFO : Element 'id-com.example.calculator:id/factorone' 
attribute 'name' is "输入 框 * 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase017 
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从 执行 结果 看 , “Element 'id=com.example.calculator:id/factorone' attribute 'name' is ' 输 入 
框 ”， 正 好 和 “输入 框 ”能 匹配 上 。 


【示例 2】 改 用 locator 为 class=android.widget.Button 和 attr_name=name 来 进行 匹配 验证 ， 
并 且 看 一 下 当 locator 匹配 到 多 个 元 素 时 是 如 何 进 行 处 理 的 。 


Open Application http://localhost:4723/wd/hub platformName=Android 
platformVersion=22 deviceName=98YFBP522VSU 
app=C: /Users/yongqing/Desktop/app-debug.apk 
appPackage=com.example.calculator appActivity=MainActivity 

Element Attribute Should Match class-android.widget.Buttonname it* True 


执行 结果 如 下 : 


Starting test: RobotFrameworkTest1.TestSuite5.TestCase018 

20170520 15:06:29.527 : INFO : msg:find class=android.widget.Button 

20170520 15:06:29.527 INFO : prefix: class 

20170520 15:06:29.527 : INFO : criteria: android.widget.Button 

20170520 15:06:31.214 : INFO : elements: 

[<appium.webdriver.webelement .WebElement 
(session="dce6f£097-98d2-4632-8708-598e2f693721", element="1")>, 
<appium.webdriver .webelement .WebElement 
(session-"dce6f097-9882-4632-8708-598e2f693721", element="2") >] 

20170520 15:06:31.214 : INFO : CAUTION: 'class-android.widget.Button' matched 
2 elements - using the first element only 

20170520 15:06:31.243 : INFO : Element 'class-android.widget.Button' attribute 
'name' is 'ib*' 

Ending test: RobotFrameworkTestl.TestSuite5.TestCase018 


从 执行 结果 看 ， 当 通过 class-android.widget.Button. 获取 到 两 个 元 素 时 ， 默 认 只 会 使 用 第 
一 个 元 素 ， 能 和 预期 结果 匹配 上 。 


4.2.15 Element Name Should Be 和 Element Value Should Be 


这 是 两 个 断言 关键 字 ， 对 元 素 Element 的 name 和 value 的 值 进行 直接 断言 处 理 。 

Element Name Should Be 关键 字 用 来 断言 指定 元 素 的 名 称 是 否 和 预期 的 一 致 , 接收 [ locator 
| expected ] 两 个 参数 。 

Element Value Should Be 关键 字 用 来 断言 指定 元 素 的 value 值 是 否 和 预期 的 一 致 ， 接 收 
[ locator | expected ] 两 个 参数 。 


4.2.16 AppiumLibrary 库 其 他 的 常见 自动 化 关键 字 
表 4-2-2 中 描述 了 AppiumLibrary 库 中 剩余 其 他 关键 字 的 用 法 。 
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表 4-2-2 AppiumLibrary 库 中 其 他 关键 字 的 用 法 


Input Password 


关键 字 使 用 描述 

Close Application 关闭 掉 当 前 已 经 打开 的 APP Application， 该 关键 字 不 需要 接收 任何 参数 ， 但 是 使 用 
该 关键 字 的 前 提 是 已 经 打开 了 一 个 APP Application 

Close All | 关闭 掉 当 前 已 经 打开 的 所 有 APP Application， 该 关键 字 不 需要 接收 任何 参数 

Applications 

Background App 让 当前 APP Application 运行 在 后 台 ， 该 关键 字 接收 一 个 参数 [后 台 运行 的 时 间 ]， 示 
pi: 

Background App 5s 

Capture Page | 获取 当前 页 面 的 截图 如果 对 该 关键 字 没有 传 入 任何 参数 ， 就 会 默认 将 获取 到 的 截图 

Screenshot 命名 为 appium-screenshot-<counter>.png， 并 且 保 存 到 RobotFramework 的 运行 日 志 目 
录 下 ， 在 案例 运行 失败 时 ， 经 常 需要 保存 截图 来 辅助 定位 和 分 析 

Set Appium | 设置 Appium 的 超时 时 间 ， 该 关键 字 接 收 一 个 参数 [超时 的 时 长 ， 单 位 为 秒 ] 

Timeout 

Get Appium | 获取 不 同 关键 字 使 用 的 超时 时 间 

Timeout 

Go Back 返回 到 浏览 器 的 上 一 个 操作 步骤 ， 相 当 于 浏览 器 的 后 退 按钮 功能 

Go To Url 在 默认 的 浏览 器 上 打开 一 个 url 地 址 ， 该 关键 字 接收 一 个 参数 [ 待 打 开 的 url] 

Hide Keyboard 隐藏 当前 操作 设备 的 键盘 。 需 要 注意 的 是 ， 该 关键 字 在 安 卓 手机 上 执行 时 可 以 不 加 任 


何 参数 ， 在 OS 手机 上 执行 时 可 以 使 用 ` key_name ` 按 特定 的 键 
该 关键 字 和 Input Text 关键 字 的 功能 基本 一 致 ， 只 是 当 使 用 该 关键 字 时 ， 日 志 中 不 会 
记录 输入 的 password 


Register Keyword 
To Run On Failure 


92 


Input Value 该 关键 字 只 适用 于 iOS 设备 ， 可 以 接收 两 个 参数 [ locator | text ] 

Lock 锁定 手机 设备 

Long Press 该 关键 字 用 于 模拟 长 按 APP 界面 的 某 个 元 素 ， 接 收 一 个 参数 [locator ] 

Long Press Keycode | 该 关键 字 用 于 模拟 长 按 手 机 设备 上 的 一 个 按键 ， 接 收 两 个 参数 [ keycode | 
metastate=None ]。 注 意 ， 该 关键 字 只 适用 于 安 卓 设备 

Press Keycode 该 关键 字 只 适用 于 安 卓 设 备 ， 模 拟 对 键盘 上 的 按键 进行 操作 ， 如 模拟 Cul 或 者 Alt 
键 。 该 关键 字 接收 两 个 参数 [ keycode | metastate=None ] 

Pull File 该 关键 字 用 于 从 手机 设备 上 下 拉 文 件 ， 接 收 两 个 参数 [ path | decode=False ]。 其 中 ， 
path 参数 指 的 是 设备 上 文件 的 路 径 ; decode 参数 指 的 是 是 否 按照 base64 来 解码 ， 默 
WA False 

Pull Folder 该 关键 字 和 Pull File 关键 字 用 法 相似 接收 两 个 参数 [ path | decode=False ]. 其 中 , path 
参数 指 的 是 设备 上 文件 的 路 径 ，decode 参数 指 的 是 是 否 按照 base64 来 解码 ， 默 认为 
False 

Push File 该 关键 字 的 功能 和 Pull File 关键 字 相反 ， 用 于 向 手机 设备 上 传 文件 。 该 关键 字 接收 三 
个 参数 [ path | data | encode=False ]: path 参数 指 的 是 设备 的 路 径 ，data 参数 指 的 是 待 
传 入 到 设备 上 的 文件 ，encode 参数 指 的 是 是 否 按照 base64 来 编码 ， 默 认为 False 

Remove Application | 该 关键 字 用 于 移 除 设备 上 的 application， 接 收 一 个 参数 [application_ id ]， 示 例 : 


Remove Application com.example.calculator 
该 关键 字 用 于 指出 在 案例 执行 失败 时 需要 执行 哪个 关键 字 。 示 例 : 
Register Keyword To Run On Failure Log Source 
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( 续 表 ) 

关键 字 使 用 描述 

Scroll 该 关键 字模 拟 屏幕 滚动 或 者 滑动 ， 接 收 两 个 参数 [ start_locator | end locator], TAR 
拟 从 一 个 元 素 滑动 到 另 一 个 元 素 

Scroll To 该 关键 字 和 Scroll 关键 字 很 类 似 ， 但 是 只 接收 一 个 参数 [ locator ] 

Shake 该 关键 字 用 于 模拟 摇动 手机 设备 

Swipe 模拟 手机 滑动 ， 从 一 个 点 滑动 到 另 一 个 点 。 该 关键 字 接收 五 个 参数 [ start x | start y | 
end x | end y | duration=1000]， 滑 动 时 ， 点 的 定位 采用 坐标 的 形式 

Tay 该 关键 字模 拟 对 屏幕 元 素 进行 单 击 ， 接 收 一 个 参数 [locator ] 

Zoom 该 关键 字 用 于 缩放 一 个 元 素 ， 接 收 三 个 参数 [ locator | percent=200% | steps=1 ]: 第 一 


个 参数 为 定位 元 素 的 方式 ; 第 二 个 参数 为 缩放 的 百分比 ， 如 果 不 传 入 ， 就 默认 放大 两 
i: 第 三 个 参数 为 元 素 缩放 的 步骤 数 (number of steps in the zoom action) ， 默 认为 1 
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WebBziitiain 


Selenium Web 自动 化 


Selenium 出 来 已 经 有 很 多 年 了 ， 从 最 初 的 Seleniuml 到 后 来 的 Selenium2， 也 变 得 越 来 越 
成 熟 ， 而 且 已 经 被 很 多 公司 广泛 使 用 。Selenium 在 发 展 的 过 程 中 分 了 很 多 模块 ， 这 里 我 们 主 
要 介绍 WebDriver。WebDriver 已 经 被 很 多 浏览 器 所 兼容 。WebDriver 在 自动 化 脚本 和 浏览 器 
之 间 充 当 的 角色 和 之 前 介绍 的 Appium 很 像 。 

于 现在 很 多 的 浏览 器 都 已 经 主动 支持 和 兼容 了 WebDriver, 所 以 WebDriver 在 启动 后 会 
确认 浏览 器 的 native component 是 否 存在 可 用 而 且 版 本 匹配 ， 接 着 在 目标 浏览 器 里 启动 使 用 
Selenium 自己 设计 定义 的 协议 (WebDriver Wire Protocol) 。WebDriver Wire 协议 是 通用 的 ， 
也 就 是 说 不 管 是 FirefoxDriver 还 是 ChromeDriver 等 ， 启 动 之 后 都 会 在 某 一 个 端口 启动 基于 这 
套 协 议 的 Web 服务 。WebDriver Wire 协议 是 一 套 基于 RESTful 的 Web 服务 。 在 调用 WebDriver 
的 时 候 ， 实 际 上 是 给 在 浏览 器 上 启动 的 RESTful 服务 监听 端口 发 送 HTTP 请 求 ， 以 WebDriver 
Wire 协议 规定 的 ISON 格式 的 字符 串 来 告诉 Selenium 希望 浏览 器 执行 什么 样 的 操作 。 


5.1.1 Selenium 和 Robot Framework Selenium2Library 库 介绍 


通过 网 址 http://www.seleniumhq.org/ 可 以 访问 Selenium 官网 。 从 该 网 站 上 可 以 下 载 到 各 
种 浏览 器 运行 需要 的 Driver， 如 图 5-1-1 和 图 5-1-2 所 示 。 


Which part of Selenium is appropriate for me? 


Selenium WebDriver 


图 5-1-1 
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Third Party Drivers, Bindings, and Plugins 
Selenium can be extended through the use of plugins. Here are a number of plugins created and 
maintained by third parties. For more information on how to create your own plugin or have it listed, 
consult the docs. 
Please note that these plugins are not supported, maintained, hosted, or endorsed by the Selenium 
project. In addition, be advised that the plugins listed below are not necessarily licensed under the 
Apache License v.2.0. Some of the plugins are available under another free and open source 
software license; others are only available under a proprietary license. Any questions about plugins 
and their license of distribution need to be raised with their respective developer(s). 
Third Party Browser Drivers NOT DEVELOPED by seleniumhq 
Browser 
change issue Implementation Released 
Mozilla GeckoDriver 9.16.1 log tracker Status 2017-04-26 
change issue leni iki Released 
Google Chrome Driver 2.29 toa =e SIT DADA 
issue selenium wiki Released 
Opera pos tr r page 2017-04-04 
issue Implementation 
Micr river =A 
issue 
GhostDriver tracke 
hostDriver (Phantom3s) 一 nf talk 
š issue Released 
lUnitDriver 2.26 tracker 2017-04-04 
issue 
SafariDriver tracka 
fariDriver — 38 
issue 
in hon -= 
i à a issue Released 
andows Phone 4.14,029.19 tracker 2013-11-23 
à issue 
Selendroid - Selenium for Android = 


图 5-1-2 


从 http//www.seleniumhq.org/docs/ 地 址 可 以 查询 到 关于 Selenium 的 文档 和 介绍 等 信息 ， 
如 图 5-1-3 所 示 。 


es [L2 
E7 seleniumHQ igi - 


SU Browser Automation 


Duo M Documentation JET TTT Sug 


Navigation 


Programming Language Preference (FEWE ( csharp )( python )( ruby )( php 
Selenium Documentation » 
next Selenium Documentation 


Next topic. Contents: 


Choosing Your Selenium Tool 
Supported Browsers and Platforms 
Bexibili s 


through sponsorship. 
Ers in this Book? 
You can sponsor the Selenium. -一 一 一 一 
Aati Youd ka some ° The Documentation i£" Authors. d Present 
public recognition of your = Selenium-IDE 


generous contribution. © Introduction 


Installing the IDE. 
Selenium Sponsors Opening the IDE 
See who supports the IDE Features 
Selenium projec Building Test Cases 
Running Test Cases 
BrowserStack : 
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5.1.2 Open Browser 和 Close Browser 


在 Selenium2Library 库 中 ，Open Browser 关键 字 用 来 打开 一 个 指定 的 浏览 器 ， 该 关键 字 接 
收 如 表 5-1-1 所 示 的 参数 。 


表 5-1-1 Open Browser 关键 字 接收 的 参数 


BX (Arguments) 说 明 

url 在 浏览 器 中 需要 打开 的 url 地 址 

Browser 指定 需要 打开 的 浏览 器 类 型 ， 包 括 IE. Firefox. Chrome, Opera, Safari 
等 常用 的 浏览 器 ， 默 认 使 用 Firefox 

Alias 设 定 的 浏览 器 实例 的 别名 ， 可 以 用 于 浏览 器 之 间 的 切换 ， 默 认为 None 

remote_url 是 否 启用 通过 remote server 的 形式 来 访问 ， 默 认为 False 

desired_capabilities 可 以 指定 的 配置 参数 ， 默 认为 None 

ff profile dir 该 参数 主要 针对 火狐 浏览 器 ， 可 以 通过 该 参数 指定 Firefox profile 路 


径 ， 默 认为 None 
Close Browser 关键 字 用 来 关闭 一 个 已 经 打开 的 当前 浏览 器 。 
【示例 1】 打 开 谷歌 浏览 器 ，url 地 址 中 输入 http://www.baidu.com。 


Open Browser http://www.baidu.com chrome 


执行 结果 如 图 5-1-4 所 示 。 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0002 

20170529 15:22:55.284 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com"' 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0002 


SST. cams x 
C |& =š | https//wwwbaidu.com A| E 


Biel mo 地 四 We me zt eo o= DI 


5-1-4 
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【示例 2】 打开 正 浏览 器 ，url 地 址 中 输入 http://www.baidu.com， 然 后 关闭 浏览 器 。 


Open Browser http://www.baidu.com ie 
Close Browser 


执行 结果 如 图 5-1-5 所 示 。 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0001 
20170529 15:31:01.937 : INFO : Opening browser 'ie' to base url 
"http://www.baidu.com' 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0001 


(CE tps vos baidu.com __ -Bc| 国 EE 下, cecus x iy xcd 


Sil haz: BE as we rx zt ge D 


00% 
Baicb 5E 


5-1-5 


另外 在 使 用 TE 浏览 器 时 ， 需 要 使 浏览 器 中 安全 标签 下 的 每 个 区 域 是 否 启用 保护 模式 保持 
一 致 ， 要 么 全 部 启用 ， 要 么 全 部 不 启用 ， 如 图 5-1-6 所 示 。 不 然 的 话 容易 出 现 类 似 


“WebDriverException: Message: Unexpected error launching Internet Explorer. Protected Mode 


settings are not the same for all zones. Enable Protected Mode must be set to the same value 
(enabled or disabled) for all zones.” 的 报错 。 
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Pg & 


本 地 
Intranet 


Taternet 


Q gampa pass 


TMAR: e 


保护 模式 
Internet Explorer) F) 


5.1.3 Input Text 
Input Text 关键 字 用 于 模拟 向 一 个 输入 框 中 输入 文字 内 容 。 该 关键 字 接 收 两 个 参数 [ locator 
|text]: locator 参数 指 的 是 定位 界面 元 素 的 方式 ，text 参数 指 的 是 需要 输入 的 内 容 。 


【示例 】 打 开 百 度 页 面 ， 向 输入 框 中 输入 “Robot FrameWork”， 这 里 采用 id 的 方式 来 定 
位 界面 的 输入 框 元 素 , 可 以 采用 谷歌 浏览 器 自 带 的 开发 者 工具 查看 该 输入 框 的 元 素 , 如 图 5-1-7 
所 示 。 


[c CS S: nups/wawbakducom *B | 


RÓ te 
Al hold ge BH we sk 92 ce B 


Baie 
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Open Browser http://www.baidu.com chrome 
Input Text id=kw Robot FrameWork 


执行 结果 如 图 5-1-8 所 示 。 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0002 

20170529 15:44:23.918 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com' 

20170529 15:44:32.068 : INFO : Typing text 'Robot FrameWork' into text field 
'id-kw' 

Ending test: — RobotFrameworkTestl.TestSuite6.TestCase0002 


oe = — 
— 
robot framework ARNE RHE 
— 
— 


O sunses: nawa I 
| 


AER 


Robot Framework 

ZERHZSSUTEN mut BEE 

Executing tho tst suit fle from provious example, wo got the meat and bone of Robot. 
Framework: A comprchonsive dobricfing on wnat happenod in tho 


Robot Framework EISE , 下 Nokia Siemens Netuci 
Framer Rp oR STERA, HR ATUS] 
Ea: SE ROE 


bake baku com! ~ -me 


tobotframework/robotframework - GitHub 


5.1.4 Click Button 
Click Button 关键 字 用 于 模拟 单 击 页 面 中 的 按钮 ， 接 收 一 个 参数 [ locator ] 。 


【示例 】 打 开 百 度 页 面 ， 向 输入 框 中 输入 “Robot FrameWork” 后 ， 单 击 “百度 一 下 ” 按 
钮 ， 进 行 搜索 。 
这 里 通过 id=su 来 定位 “百度 一 下 ”这 个 按钮 ， 如 图 5-1-9 所 示 。 


Open Browser http://www.baidu.com chrome 


Input Text id=kw Robot FrameWork 
Click Button id=su 
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Er E | p= 


Robot Framework 
SEMEN, ASTMELT 
Executing the les surte file from previous example. we get the meat and bone of Robet 


selene Iwebenve PILL 为 和 一 在 区 于 seo 
A wenblogs coming. ~ ignes Mame 


‘Robot Framework TST 

Robot Famswoih BRIF Nokia Semans NetwomsFETIERES, BR 
Frames B python SESS LIOR, RETT RI oh 
mi se nre 

ake baidu conv ~ -e 


robot Gu 
obollrarewon - Goran tast automation hamewod Rabot rameweo s agerem open 


source lest automation famen for acceptance lasting and acceptam 
Mipsigtnub cor robotrames...- - EIRIAS - 534) - BERAT 


na 

eckeroura en 

Fheiérosd cil. border 
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Starting test: RobotFrameworkTestl.TestSuite6.TestCase0002 

20170529 16:01:02.161 INFO : Opening browser 'chrome' to base url 
"http://www.baidu.com' 

20170529 16:01:12.505 INFO : Typing text 'Robot FrameWork' into text field 
'id-kw' 

20170529 16:01:12.917 INFO : Clicking button 'id-su'. 

Ending test: ^ RobotFrameworkTestl.TestSuite6.TestCase0002 


Q | à 安全 | https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=0&rsv_idx=1&tn=baidu&wd=Robot%20FrameWork&rsv_pq=b85 3r | 加 


pe, 
Bai MEE | Robot FrameWork 


网 页 “新闻 贴吧 知道。 音乐 


图 片 ”视频 ”地 图 we S me» 


varia 


Fim ste 392 0004 


O seua : 英文 结果 


Robot Framework 
查看 此 网 页 的 中 文 翻译， 请 点 击 ELT 

Executing the test suite file from previous example, we get the meat and bone of Robot 
Framework: A comprehensive debriefing on what happened in the. 
robotframework or ~ -EiEte8S -iE 


2014 年 7 月 27 日 https://pypi.python org/pypilrobotframework- 
seleniumzlibrary/1.5.0RF-seleniumlibrary 可 以 看 后 RF 版 的 selenium 
Œ selenium (webdriverj 可 以 认为 是 一 各 基于 web 的 
www.cnblogs.com/fnng/p... + - EERS - 9393 条 评价 

Robot Framework FESE 

Robot Framework 是 开源 软件 ， 由 Nokia Siemens Networks 开 发 并 提供 支持 .简介 Robot 


Framewok 是 一 款 python 编 写 的 功能 让 动 化 刘斌 框架 具备 良 好 的 可 扩展 性 ,支持 关 
Ba 每 性 RIDE 


图 5-1-10 
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5.1.5 Click Element 
Click Element 关键 字 用 于 模拟 单 击 一 个 通过 locator 定位 到 的 具体 元 素 ， 可 以 是 通过 id 或 
者 name, xpath 等 。 该 关键 字 接 收 一 个 参数 [ locator ]。 
【示例 】 这 里 我 们 继续 访问 百度 的 首页 , 通过 id 来 定位 一 个 元 素 , 并 且 使 用 Click Element 
关键 字 来 模拟 单 击 这 个 元 素 定 位 到 的 按钮 ， 如 图 5-1-11 所 示 。 


图 5-1-11 


Open Browser http: //www.baidu.com chrome 
Click Element  id-su 

Sleep 2 

Close Browser 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0003 

20180728 09:59:02.582 : INFO : Opening browser 'chrome' to base url 
'http://www.baidu.com" 

20180728 09:59:14.272 : INFO : Clicking element 'id-su'. 

20180728 09:59:17.158 : INFO : Slept 2 seconds 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0003 


5.1.6 Click Link 
Click Link 关键 字 用 于 模拟 单 击 一 个 链接 。 该 关键 字 接 收 一 个 参数 [ locator ] 。 
【示例 1】 这 里 我 们 继续 访问 百度 的 首页 ， 通 过 模拟 单 击 百度 首页 右上 角 的 “地 图 ”链接 
来 说 明 此 关键 字 的 使 用 。 下 面 通过 href="http://map.baidu.com" 来 模拟 单 击 这 个 链接 ， 如 图 
5-1-12 所 示 。 
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[€ C [a e | htipsywwwbaiducom 


Bai 人 百度 


“STATUS 0K--> 
m 
P hands. /mead 


图 5-1-12 


Open Browser http://www.baidu.com chrome 
Click Link http://map.baidu.com 

Sleep 2 

Close Browser 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0004 

20180728 10:10:37.328 : INFO : Opening browser 'chrome' to base url 
"http://www.baidu.com' 

20180728 10:10:47.171 : INFO : Clicking link 'http://map.baidu.com'. 
20180728 10:10:53.170 : INFO : Slept 2 seconds 

Ending test: RobotFrameworkTest1.TestSuite6é.TestCase0004 


【示例 2] Click Link 关键 字 除了 上 面 说 到 的 直接 通过 href 链接 来 定位 元 素 外 ， 也 可 以 通 
过 id 或 者 name 来 定位 ， 这 里 以 name 为 例 进行 演示 。 
Open Browser http://www.baidu.com 
Click Link name=tj_trmap 


Sleep 5 
Close Browser 


执行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0005 
20180728 10:22:35.467 : INFO : Opening browser 'chrome' to base url 


'http://www.baidu.com"' 
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20180728 10:22:44.921 : INFO : Clicking link 'name=tj_trmap'. 

20180728 10:22:57.497 : INFO : Slept 5 seconds 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0005 
运行 时 可 以 看 到 正在 加 载 百 度 地 图 的 界面 ， 如 图 5-1-13 所 示 。 


. 百度 地 图 x 
€ X | @ 安全 | https://map.baidu.com 


Chrome 正 各 到 自动 测试 次 件 的 控制. 


a aware Bus miss. mf 4 


图 5-1-13 


5.1.7 Add Cookie, Get Cookie 和 Delete Cookie 

Add Cookie 关键 字 用 于 模拟 向 本 地 浏览 器 中 添加 一 个 Cookie ££, Cookie 也 是 我 们 在 做 
Web 自动 化 测试 时 经 常 需要 用 到 的 一 个 概念 。 该 关键 字 接收 [ name | value | path=None | 
domain=None | secure=None | expiry=None ] 这 几 个 参数 ， 如 表 5-1-2 所 示 。 


表 5-1-2 Add Cookie 关键 字 的 参数 


Cookie 的 名 称 
Value Cookie 的 具体 值 
| path | Cookie 对 应 的 路 径 ， 如 果 不 填 就 默认 为 None 


domain — | Cookie 对 应 的 域名 ， 如 果 不 填 就 默认 为 None 

Cookie 的 安全 属性 ， 用 来 保证 Cookie 安全 的 。 如 果 一 个 Cookie 被 设置 了 Secure=tue, MA 
这 个 Cookie 只 能 用 HTTPS 协议 发 送 给 服务 器 ， 用 HTTP 协议 是 不 发 送 的 

Cookie 的 过 期 时 间 ， 如 果 不 填 ， 默 认为 空 


secure 


expiry 
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这 里 以 登录 到 作者 的 博客 园 后 浏览 器 中 显示 的 Cookie 为 示例 ， 如 图 5-1-14 所 示 ， 上 面 表 


格 中 对 应 的 字段 都 可 以 在 浏览 器 的 Cookie 中 看 到 。 


n 


5-1-14 


Get Cookie 关键 字 用 于 获取 浏览 器 中 缓存 的 所 有 Cookie, 这 个 关键 字 后 面 不 需要 加 任何 的 
参数 。 
Delete Cookie 关键 字 用 于 删除 浏览 器 中 缓存 的 Cookie。 该 关键 字 接 收 一 个 参数 [ name ]， 
用 于 标志 需要 删除 的 Cookie 的 名 称 。 
【示例 ] 这 里 我 们 以 访问 百度 首页 为 例 , 添加 一 个 名 称 为 book 的 Cookie, 并 且 将 该 Cookie 
的 值 写 为 Robot Framework, secure 属性 设置 为 True, 然后 通过 Get Cookies 关键 字 来 获取 所 有 
的 Cookie， 再 删除 我 们 自己 添加 的 Cookie。 


Open Browser http: //www.baidu.com chrome 
Add Cookie book Robot Framework / baidu.com true 
${cookie} Get Cookies 
log ${cookie} 
Sleep 50 
Delete Cookie book 
${cookienew} Get Cookies 
log ${cookienew} 
Sleep 2 
Close Browser 
运行 结果 如 下 : 
Starting test: RobotFrameworkTestl.TestSuite6.TestCase0006 
20180728 11:02:14.076 : INFO : Opening browser 'chrome' to base url 
"http://www.baidu.com' 
20180728 11:02:24.488 : INFO : ${cookie} = 
H PS PSSID-26523 1443 26433 21112 26924 20930; 
BAIDUID=5 3A9ECC2223045BB4D28064D8CCC2428:FG=1; PSTM=1532746930; 
BIDUPSID=53A9ECC2223045BB4D28064D8CCC2428; delPer=0; BD_HOME=0; 
BD_UPN=12314353; book= Robot Framework 


20180728 11:02:24.489 : INFO : H PS PSSID-26523 1443 26433 21112 26924 20930; 
BAIDUID=5 3A9ECC2223045BB4D28064D8CCC2428:FG=1; PSTM=1532746930; 
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BIDUPSID-53A9ECC2223045BB4D28064D8CCC2428; delPer-0; BD HOME-0; 
BD_UPN=12314353; book-Robot Framework 

20180728 11:03:14.490 : INFO : Slept 50 seconds 

20180728 11:03:15.772 : INFO : ${cookienew} = 

H PS PSSID-26523 1443 26433 21112 26924 20930; 
BAIDUID-53A9ECC2223045BB4D28064D8CCC2428:FG-1; PSTM-1532746930; 
BIDUPSID-53A9ECC2223045BB4D28064D8CCC2428; delPer-0; BD HOME-0; BD UPN-12314353 
20180728 11:03:15.773 : INFO : H PS PSSID-26523 1443 26433 21112 26924 20930; 
BAIDUID-53A9ECC2223045BB4D28064D8CCC2428:FG-1; PSTM-1532746930; 
BIDUPSID-53A9ECC2223045BB4D28064D8CCC2428; delPer-0; BD HOME-0; BD UPN-12314353 
20180728 11:03:17.775 : INFO : Slept 2 seconds 

Ending test: — RobotFrameworkTestl.TestSuite6.TestCase0006 


从 运行 的 日 志 结 果 看 ， 通 过 “Add Cookie book Robot Framework/baidu.comtrue” , Fy LAYS 
加 一 个 Cookie， 并 且 可 以 将 该 Cookie 的 secure 属性 设置 为 True。 在 运行 的 过 程 中 ， 通 过 浏览 
器 自 带 的 开发 者 工具 ， 可 以 看 到 名 称 叫 book 的 Cookie 已 经 成 功 添加 完成 ， 如 图 5-1-15 所 示 。 


Elements Console Sources Network Performance Memory Application Security Audts JLH 


O O x fitter 
88595 Name Value Domain Expres /Max..|Su|HTTP |Secure _|SameSi. 
1X Service Workers SAIDUID 5349ECC2223045884D28064D8CCC2428fG=1 | baiducom 2086-08-57. 

Ë Clear storage BD HOME 0 www.baidu.co. Session. 
8D UPN 12314353 wwebsiduco .| / | 2018-08077. 
aaa BIDUPSIO 53A9ECC2223045884D28064D8CCC2428 baiducom — |/ | 2086-08-15T. 
Hps PSSID 26523,1443 25433, 21112 26924 20030 baiducom Session 

PSIM 1532746930 baiducom — |/ | 2085-0815T 

book Robot Framework baiducom |/ | Session 

delPer 0 wwwbaiduco.- / | 2048-07-20T. 


> BE Local Storage 
> BB Session Storage 
E indexed! 
B wen sau 
Y ® Cockies 
@@ hitps//wwwbaiducom 


B 5-1-15 


在 使 用 Get Cookies 关键 字 时 ， 可 以 获取 到 浏览 器 打开 后 里 面 所 有 的 Cookie， 除 了 获取 到 
这 里 我 们 自己 添加 的 Cookie 外 ， 还 获取 到 了 访问 百度 首页 时 百度 首页 在 本 地 浏览 器 中 保存 的 
Cookie。 最 后 通过 Delete Cookie 关键 字 删 除名 称 为 book 的 Cookie 后 ， 再 通过 Get Cookies 关 
键 字 来 获取 所 有 的 Cookie 就 已 经 不 能 获取 到 名 称 为 book 的 Cookie 信息 了 。 


5.1.8 Get All Links 


Get All Links 关键 字 用 来 获取 所 有 页 面 上 所 有 的 href 链接 的 元 素 对 应 的 id， 链接 对 应 的 
元 素 中 没有 id 时 ， 就 以 一 个 空 字 符 串 代替 。 


【示例 】 我 们 继续 访问 百度 ， 找 出 百度 首页 中 存在 多 少 个 链接 数 。 


Open Browser http://www.baidu.com/ chrome 
${links} Get All Links 

log ${links} 

Sleep 2 

Close Browser 


运行 结果 如 下 : 
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Starting test: RobotFrameworkTestl.TestSuite6.TestCase0007 
20180728 11:31:18.136 : INFO : Opening browser 'chrome' to base url 
'http://www.baidu.com/" 

20180728 11:31:28.558 : INFO : get attribute id 
20180728 11:31:28.566 : INFO : get attribute id 
20180728 11:31:28.574 : INFO : get attribute id 
20180728 11:31:28.582 : INFO : get attribute id 
20180728 11:31:28.592 : INFO : get attribute id 
20180728 11:31:28.599 : INFO : get attribute id 
20180728 11:31:28.607 : INFO : get attribute id 
20180728 11:31:28.617 : INFO : get attribute id 
20180728 11:31:28.624 : INFO : get attribute id 
20180728 11:31:28.633 : INFO : get attribute id 
20180728 11:31:28.640 : INFO : get attribute id 
20180728 11:31:28.648 : INFO : get attribute id 
20180728 11:31:28.657 : INFO : get attribute id 
20180728 11:31:28.664 : INFO : get attribute id 
20180728 11:31:28.673 : INFO : get attribute id 
20180728 11:31:28.682 : INFO : get attribute id 
20180728 11:31:28.690 : INFO : get attribute id 
20180728 11:31:28.699 : INFO : get attribute id 
20180728 :28.706 : INFO : get attribute id 
20180728 11:31:28.716 : INFO : get attribute id 
20180728 11:31:28.723 : INFO : get attribute id 
20180728 11:31:28.732 : INFO : get attribute id 
20180728 11:31:28.740 : INFO : get attribute id 
20180728 11:31:28.747 : INFO : get attribute id 
20180728 11:31:28.756 : INFO : get attribute id 
20180728 11:31:28.764 : INFO : get attribute id 


20180728 INFO : get attribute id 
20180728 INFO : get attribute id 
20180728 INFO : get attribute id 
20180728 INFO : get attribute id 
20180728 INFO : get attribute id 
20180728 INFO : get attribute id 


20180728 : INFO : get attribute id 

20180728 11:31:28.831 : INFO : ${links} = [u'result logo', u'quickdelete', u'', 
u'', an, ut, ua a, aU, aU, an, ua aU, at, u gt, gt, gt, out, 
u'', u'', ult, ult, u'', u'', ult, u'setf', ult, u'', u'', utt, u'', u'jgwab'] 
20180728 11:31:28.833 : INFO : [u'result logo', u'quickdelete', u'*, u'', u'', 
u'', u'', u'', ut, ut, ut', a, utt, ut, at, at, ot, at, ut, ut, utt, 
u'', u'', u'', u'', u'', u'set£', u'', u'', ut", u'', u'', u'jgwab'] 

20180728 11:31:30.833 : INFO : Slept 2 seconds 

Ending test: | RobotFrameworkTestl.TestSuite6.TestCase0007 


5.1.9 Choose File 


做 自动 化 测试 时 ， 我 们 经 常 遇 到 的 就 是 上 传 文件 了 。 这 里 我 们 可 以 使 用 Choose File 关键 
字 完 成 该 操作 。Choose File 关键 字 接 收 [ locator | file path ] 两 个 关键 字 ， 如 表 5-1-3 所 示 。 
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表 5-1-3 Choose File 关键 字 接 收 的 关键 字 


EE 说 明 
locator 上 传 文件 时 ， 上 传 文件 对 应 的 输入 框 的 输入 字段 可 以 通过 我 们 常见 的 元 素 定位 的 方式 来 
定位 到 
| file. path | 这 个 参数 指 的 是 需要 上 传 的 文件 的 本 地 路 径 


【示例 】 这 里 我 们 还 是 以 百度 首页 为 例 。 百 度 首页 支持 图 片 搜索 ,很 多 经 常 使 用 百度 引擎 

进行 搜索 的 朋友 可 能 都 用 过 , 它 有 点 类 似 通过 输入 一 张 图 片 , 然后 查找 和 这 张 图 片 的 相似 图 片 
功能 一 样 。 在 目前 人 工 智能 技术 大 热 的 时 代 ， 这 个 功能 被 越 来 越 多 的 电 商 用 于 商品 搜索 。 

我 们 首先 打开 百度 首页 ， 然 后 通过 上 面 介 绍 的 Click Element 关键 字模 拟 单 击 输 入 框 旁 边 
的 四 按钮 来 切换 到 图 片上 传 模式 。 切换 完 后 , 通过 Choose File 关键 字 来 上 传 文件 , 使 用 xpath 
来 定位 (locator) 。 之 后 就 是 选择 磁盘 中 的 一 张 个 人 图 片上 传 。 

在 获取 xpath 路 径 时 , 我 们 可 以 通过 Chrome 浏览 器 自 带 的 开发 者 工具 来 直接 复制 到 xpath 
路 径 ， 如 图 5-1-16 所 示 。 


图 5-1-16 


Open Browser http://www.baidu.com/ chrome 
Click Element  //*[8id-"form"]/span[1]/span 


Sleep 10 
Choose File //* [@id="form"] /div/div[2]/div[2] /input E:\\zhangyongqing. bmp 
Sleep 10 


Close Browser 
运行 结果 如 下 《〈 这 里 的 运行 结果 是 从 自动 化 执行 report 中 来 查看 的 ) : 


SUITE RobotFrameworkTest1 


javascript:expandAll ('s1") javascript:collapseAll ('s1')C:\Users\yongqing\AppDa 
ta\Local\Temp\RIDExpjcyt.d\log.html - sl#sl 
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RobotFrameworkTestl 


Re 


javascript:expandAll ('sl-s1') javascript:collapseAl11 ('sl-s1")C:\Users\yongqing 
\AppData\Local\Temp\RIDExpjcyt.d\log.html - sl-sl#sl-sl 


RobotFrameworkTest1.TestSuite6 


F:\project\RobotFrameworkTest1\RobotFrameworkTest]\TestSuite6.txt 


20180728 11:52:36.841 / 20180728 11:53:08.125 / 00:00:31.284 


Status: 1 critical test, 1 passed, 0 failed 
1 test total, 1 passed, 0 failed 
00:00:31.108TEST TestCase0008 


javascript:expandAll('s1-s1-t1')javascript:collapseAll(‘s 1-s1-t1')C:\Users\yongqing\AppData\Lo 
cal\Temp\RIDExpjcyt.d\log.html - s1-s1-tl#s1-s1-tl 


RobotFrameworkTest1.TestSuite6. TestCase0008 
Start / End / Elapsed: 20180728 11:52:37.016 / 20180728 11:53:08.124 / 00:00:31.108 
BASS (ica 


00:00:09.825KEYWORD Selenium2Library . Open Browser http://www.baidu.com/, 
chrome 


javascript:expandAll('sl-sl-tl-k1')javascript:collapseAll('s1-sl-tl-k1l')C:NUs 
ers\yongqing\AppData\Local\Temp\RIDExpjcyt.d\log.html - 
sl-sl-ti-kl£sl-si—ti-ki] 


cement anew browser instance to given URL. 
Start / End / Btart / End / Elapsed: — | 


20180728 11:52:37.017 / 20180728 11:52:46.842 / 00:00:09.825 


11:52 (Opening browser 'chrome' to base url 
|http://www.baidu.com/ 


00:00:00.119KEYWORD Selenium2Library . Click Element //*[@id="form"/span[1]/span 
javascript:expandAll('sl-sl-tl-k2')javascript:collapseAll('si-sl1-tl-k2')C:NUs 
ers\yongqing\AppData\Local\Temp\RIDExpjcyt.d\log.html - 
Sl-sl-ti-k24s1-sl-ti-k2 


fbocumentation Click element identified by ‘locator’. 


108 


第 5 章 Web 自动 化 


00:00:10.001KEYWORD BuiltIn . Sleep 10 
javascript:expandAll ('sl-sl-t1-k3') javascript:collapseAl1 ('sl-s1-t1-k3')C:\Us 
ers \yongqing\AppData\Local\Temp\RIDExpjcyt.d\log.html - 
s1-sl-tl-k34s1-s1-tl-k3 


11:52:56.962 [ro — |stept 10 seconds 


00:00:00.095KEYWORD Selenium2Library . Choose File //*[@id="form")/div/div[2]/div 
[2]/input, E:\\zhangyongging.bmp 
javascript:expandAll('sl-sl-tl-k4')javascript:collapseAll('sl-sl-tl-k4')C:NUs 


ersNVyonggingMAppDataNLocalVTempNRIDExpjcyt.dMlog.html - 
Sl-sl-tl-k4fsl-sl-tl-k4 


Inputs the "file path into file input field found by ‘locator’. 
Start / End / Elapsed: 20180728 11:52:56.964 / 20180728 11:52:57.059 / 00:00:00.095 


00:00:10.002KEYWORD BuiltIn . Sleep 10 


javascript:expandAll('sl-sl-tl-k5')javascript:collapseAll('s1-sl-tl-k5')C:NUs 
ers\yongqing\AppData\Local\Temp\RIDExpjcyt.d\log.html - 
sl-sl-tl-k5s$sl-sl1-tl-k5 


Pauses the test executed for the given time. 
Start / End / Elapsed: 20180728 11:52:57.060 / 20180728 11:53:07.062 / 00:00:10.002 


11:53:07.061 INFO [stept 10 seconds 


00:00:01.061KEYWORD Selenium2Library . Close Browser 
javascript:expandAll('si-si-tl-k6')javascript:collapseAll('si-sl-tl-k6')C:NUs 
ers\yongqing\AppData\Local\Temp\RIDExpjcyt.d\log.html - 
sl-sl-tl-k6ssl-sl-tl-k6 


2 


'ocumentation: Closes the current browser. 


Start / End / Elapsed: 20180728 11:53:07.063 / 20180728 11:53:08.124 / 00:00:01.061 


为 了 能 看 到 整个 过 程 , 我 们 捕获 了 运行 过 程 中 关键 步 又 执行 时 的 实际 效果 图 片 。 从 图 片 中 
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可 以 清楚 地 看 到 图 片 从 上 传 到 上 传 后 百度 引擎 自动 执行 搜索 的 一 个 过 程 ， 如 图 5-1-17、 图 
5-1-18、 图 5-1-19 所 示 。 


€ 


C |& =š | https//www.baidu.com 


Bi hool23 地 图 we WE Sk Se oe E 


ee 
Baise 
THEY at | @ | 


ES] nezn WS we e 全 本 BT oe LIU 


e, 
Bai 百度 


在 比 处 由 由 图 片 问 址 


5-1-18 
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FERRES —————" 识 图 效果 不 好 ? SPA RMI H IE x 
m: 加 关键 词 或 框 丢 加 片 优化 识 图 结果 


尺寸: 301X377 


5-1-19 


5.1.10 Get Text 


Get Text 关键 字 用 来 获取 文本 内 容 ， 该 关键 字 接收 [ locator ] 这 一 个 关键 字 。locator 可 以 通 
过 id、name、xpath 等 来 定位 。 


【示例 1】 这 里 我 们 依然 以 百度 首页 为 例 ， 获 取 name="tj tmews" 包含 的 文本 内 容 ， 如 图 
5-1-20 所 示 。 


£ cj 


Tips /Jwww baidu. com 


[= me 


[i D eee 


图 5-1-20 
Open Browser http://www.baidu.com/ chrome 
${text} Get Text name=tj_trnews 
log ${text} 
Close Browser 
运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0009 

20180728 13:04:33.505 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com/" 
20180728 13:04:42.409 : INFO 
20180728 13:04:42.411 : INFO 


$(text) = 新 闻 
新 闻 
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Ending test: RobotFrameworkTestl.TestSuite6.TestCase0009 


【示例 2】 在 上 面 的 示例 中 ， 我 们 的 locator 是 通过 name 来 定位 的 ， 本 示例 换 成 xpath 来 
Open Browser http://www.baidu.com/ chrome 
${text} Get Text //* (@id="ul"] /a[1] 


log ${text} 
Close Browser 


运行 结果 (从 自动 化 执行 report 中 来 查看 ) 如 图 5-1-21 所 示 。 


- HJ TestCase0010 


Full Name: RobotFrameworkTest1. TestSuite6. TestCase0010 
Start / End / Elapsed: — 20180728 13:11:38.288 / 20180728 13:11:50.264 / 00:00:11.976 
Status: EEJ critical) 
= CSL seenum2tbrary.Open Browser http://www. baidu com/, chrome 
Documentation: Opens a new browser instance to given URL. 
Start / End / Elapsed: 20180728 13:11:38 289 / 20180728 13:11:48.933 / 00:00:10.644 
13:11:38. 290 INFO Opening browser ‘chrome’ to base url ‘http://www. baidu. com/” 
= S(text) = Seenum2LUbrary.Get Text //*[@id="u1")/a[ 1] 
Documentation: Returns the text value of element identified by “locator 


Start/End/Elapsed: — 20180728 13:11:48.934 /20180728 13:11:48.990 / 00:00:00.056 
13:11:48, 990 INFO $ttext} = 新 闻 


= Bumn.Log St) 
Documentation: Logs the given message with the given level 


Start / End / Elapsed: 20180728 13:11:48.991 / 20180728 13:11:48.992 / 00:00:00.001 
13:11:48.992 INFO Ñ 


= Selenium2L ixary .Close Browser 
Documentation: Closes the current browser. 
Start / End / Elapsed: 20180728 13:11:48.992 / 20180728 13:11:50.264 / 00:00:01.272 


B 5-1-21 


我 们 发 现 使 用 xpath 的 效果 是 一 样 的 。 


5.1.11 Get Title 
Get Title 关键 字 用 来 获取 浏览 器 网 页 的 tile， 该 关键 字 后 面 不 需要 接收 任何 参数 。 
【示例 】 这 里 我 们 模拟 访问 百度 首页 ， 然 后 获取 百度 首页 的 Title 


Open Browser http://www.baidu.com/ chrome 
${title} Get Title 

log ${title} 

Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0011 

20180728 13:18:33.227 : INFO : Opening browser 'chrome' to base url 
'http://www.baidu.com/" 

20180728 13:18:42.213 : INFO : $(title) = 百度 一 下 ， 你 就 知道 

20180728 13:18:42.214 : INFO : 百度 一 下 ， 你 就 知道 
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| Ending test: — RobotFrameworkTestl.TestSuite6.TestCase0011 | 


5.1.12 Get Value 


Get Value 关键 字 用 于 获取 某 个 元 素 标签 对 应 的 value 属性 ， 该 关键 字 接收 [ locator ] 这 一 
个 参数 。locator 可 以 通过 id、name、xpath 等 进行 定位 。 


【示例 】 这 里 我 们 以 访问 博客 园 的 登录 页 面 为 示例 ， 获 取 登 录 按 钮 对 应 的 value， 如 图 
5-1-22 所 示 。 


€ C | @ =š | https://passport.cnblogs.com/user/ 


RetumUri=https%3A%2F%2Fwww.cnblogs.com%2F 


登录 博客 园 - 代码 改变 世界 


可 录用 户 名 (二 加 ) 
saam) 
TREIER 
| sa 
[x Ó] | Bements Console Sources Network Performance Memory  Appicaticn Security Audits 


hem 
> <head>.. /nead 

Y <body onload»"setFocus() 
tyle«width: 100%; 
iv aligns" center 

iv id« Main 


Y <form method="post" ontubmit-"return falces 


div id- Heading > 登录 博客 园 ”代码 织 交 世界 */civ 


vedly class=rploc 
P clabel class= "label-Line")</label 


input type="text" id-'inputl" value class«"ingut-text" onkeydown="check_enter(event) 
span ide"tip inputl" class="tip" ></span: 


[div 
«div class="Dlock"></div 
Pxdiv class«"modal fade" id«"checilay" tabindex«"-1" role="dialog" aria-hidden-"true"i../civ 
div class-rploceryrf/diy 
Y (div class="Dlock 

span id-"tip btn 

/div 
div n 


图 5-1-22 


Open Browser 
https://passport.cnblogs.com/user/signin?ReturnUrl=https%3A%2F%2Fwww.cnbl 

ogs.com$2F chrome 

${value} Get Value id=signin 

log ${value} 

Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0012 

20180728 13:34:51.578 : INFO : Opening browser 'chrome' to base url 
'https://passport.cnblogs.com/user/signin?ReturnUrl-https$3A$2F$2Fwww.cnblogs 
-com$2F' 

20180728 13:35:00.116 : INFO : get attribute value 

20180728 13:35:00.124 : INFO : ${value} = 登录 

20180728 13:35:00.125 : INFO : 登录 
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Ending test: RobotFrameworkTestl.TestSuite6.TestCase0012 


5.1.13 Get Webelements 和 Get Webelement 


Get Webelements 关键 字 用 来 获取 所 有 获得 的 WebElement 对 象 的 列表 ， 接 收 [ locator ]— 
ASH. locator 可 以 通过 id, name, xpath 等 进行 定位 。 

Get Webelement 关键 字 和 Get Webelements 类 似 ， 只 不 过 Get Webelement 只 会 返回 匹配 
到 的 第 一 个 WebElement 对 象 。 


【示例 1】 访 问 百度 首页 ， 然 后 根据 locator 为 name-tj tmews 来 获取 可 以 匹配 到 的 所 有 
WebElement 对 象 的 列表 。 


Open Browser http: //www.baidu.com chrome 
${ement } Get Webelements name-tj trnews 
log $(ement) 

Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0013 
20180728 14:54:42.820 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com" 

20180728 14:54:50.182 : INFO : ${ement} = 
[<selenium.webdriver.remote.webelement .WebElement 
(session-"47f749d3fcd24d5037a56e6ada80f38ba", 
element="0.8260127734608302-1") >] 

20180728 14:54:50.183 : INFO : 
[<selenium.webdriver. remote.webelement .WebElement 
(session="47£749d3fcd2d5037a56e6ada80f38ba", 
element="0.8260127734608302-1") >] 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0013 


【示例 2】 访问 百 度 首页 ， 然 后 根据 locator 为 name-tj tmews 来 获取 匹配 到 的 第 一 个 
WebElement 对 象 。 


Open Browser http: //www.baidu.com chrome 

$ {ement} Get Webelement name=tj_trnews 
log ${ement } 

Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0014 

20180728 15:01:58.469 : INFO : Opening browser 'chrome' to base url 
'http://www.baidu.com' 

20180728 15:02:07.093 : INFO : ${ement} = 
«selenium.webdriver.remote.webelement .WebElement 
(session-"0382b83b32515ea731a4497ab3699131", 
element-"0.20523497043976824-1")» 

20180728 15:02:07.094 : INFO : «selenium.webdriver.remote.webelement.WebElement 
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(session="0382b83b32515ea731a4497ab3699131", 
element-"0.20523497043976824-1")» 
Ending test: RobotFrameworkTestl.TestSuite6.TestCase0014 


5.1.14 Get Window Titles 


Get Window Titles 用 来 获取 当前 已 经 打开 的 浏览 器 窗口 的 所 有 Title。 该 关键 字 不 需要 接 
收 任何 参数 。 


【示例 】 这 里 我 们 打开 百度 的 首页 ， 然 后 单 击 首页 右上 角 的 “新 闻 ” 链 接 按钮 ， 跳 转 到 百 
度 新 闻 页 面 ， 最 后 获取 该 窗口 下 的 所 有 Title。 


Open Browser http://www.baidu.com chrome 
Click Link 新 闻 
${titlel} Get Window Titles 


log ${titlel} 
Close All Browsers 


运行 结果 如 图 5-1-23 所 示 。 


- EI Testsuites 
Full Name: RobotFrameworkTest1 TestSuite6 
Source: F \project\RobolFrameworkTest1\RobotFrameworkTest 1\TestSuite6 txt 
Start! End / Elapsed: ^ 20180728 15:08:47.042 / 20180728 15:09:01.300 / 00:00:14.258 


Status: 1 critical test, 1 passed, 0 failed 
1 test total, 1 passed, 0 failed 
- [ETIS TestCase0015 
Full Name: RobotFrameworkTest1 TestSuite6 TestCase0015 
Start/ End / Elapsed: — 20180728 15.08.47 219 / 20180728 15:09 01 299 / 00:00:14.080 
Status: (critical) 


- CTE) Selenum2trary.Open Browser http//www baidu com, chrome 
Documentation: Opens a new browser instance to given URL. 
Start/End/Elapsed: — 20180728 15:08:47.220 / 20180728 15:08:56.120 / 00:00:08.900 
15:08:47, 221 INFO Opening browser ‘chrome’ to base url “http //www, baidu con’ 


- CSTI sekenumzutxary.Click Link #78) 
Documentation: Clicks a link identified by locator. 
Start/End/Elapsed: — 20180728 15:08:56.124 /20180728 15:09:00.181 / 00:00:04.057 
15:08:56. 127 INFO Clicking link ' 新 本 

- CSTI Sttitle) = setenumatitrary Get Window Titles 
Documentation: Returns and logs titles of all windows known to the browser. 
Start/End/Elapsed: — 20180728 15:09:00.182 / 20180728 15:09:00.204 / 00:00:00.022 
15:09:00, 203 INFO Altogether 1 item. 

1: 百度 新 闻 一 一 全 球 最 大 的 中 文 新 闻 平 台 


15:09:00.204 INFO $ititlel} = [w \u767e\uSee6 \u85b0\u95 fb \u2014\u2014\u5168\u7403\u8 700 \u5927 VaT684 \ude2d\uB587 \uBSbO\u95 fb \uSe73\uS3.£0" ] 
- CSLI Bumn Log stttle1) 
Documentation: 


Logs the given message with the given level, 

Start/End/Elapsed: — 20180728 15:09:00.205 / 20180728 15:09:00.206 / 00:00:00.001 

15:09:00. 205 INFO [w \u787e\uSea6 \u85b0\u95 £b \u201 4\u201 4\u5168\u7 403 \u6 700 \u5927 \u7684 \ude2 d\uBS87 \uBSbO\u95 fb \uSe73\u53.£0" ] 
- Selenum2Lbrary .Close All Browsers 

Documentation: Closes all open browsers and resets the browser cache. 

Start/End / Elapsed: — 20180728 15:09:00.206 / 20180728 15:09:01.298 / 00:00:01.092 


5-1-23 


5.1.15 Go Back 和 Go To 
Go Back 和 Go To 关键 字 分 别 用 来 模拟 对 浏览 器 进行 后 退 和 前 进 的 操作 。Go Back 关键 
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字 不 需要 接收 任何 参数 。Go To 关键 字 接收 [ url ] 一 个 参数 ，url 是 一 个 需要 跳 转 到 的 地 址 。 


【示例 】 这 里 我 们 首先 访问 百度 首页 ， 之 后 单 击 “ 新 闻 ” 链 接 ， 跳 转 到 百度 新 闻 页 面 ， 然 
后 执行 Go Back 回 退 到 百度 首页 ， 最 后 使 用 Go To 跳 转 到 博客 园 首 页 ， 在 每 一 个 操作 中 ， 我 
们 都 记录 了 浏览 器 的 窗口 标题 。 


Open Browser http://www.baidu.com chrome 
Click Link 新 闻 

${titlel} Get Window Titles 
log ${titlel} 

Go Back 

${title2} Get Window Titles 
log ${title2} 

Go To https://www.cnblogs.com/ 
${title3} Get Window Titles 
log ${title3} 

Close All Browsers 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0016 

20180728 15:26:17.443 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com" 

20180728 15:26:24.906 : INFO : Clicking link ' 新 闻 '. 

20180728 15:26:27.947 : INFO : 

Altogether 1 item. 


1: 百度 新 闻 一 一 全 球 最 大 的 中 文 新 闻 平 台 
20180728 15:26:27.948 : INFO : ${titlel} = 
[u' \u767e\u5ea6\u65b0 \u95 fb\u2014\u2014\u5168\u7403\u6700\u5927\u7684\u4e2d\u 
6587\u65b0\u95f£b\u5e73\u53£0"] 
20180728 15:26:27.949 : INFO : 
[u' \u767e\u5ea6\u65b0\u95£b\u2014\u2014\u5168\u7403\u6700\u5927\u7684\u4e2d\u 
6587Nu65b0Nu95fbNu5e73Nu53£0'] 
20180728 15:26:28.239 : INFO : 
Altogether 1 item. 
1: 百度 一 下 ， 你 就 知道 
20180728 15:26:28.240 : INFO : ${title2} = 
[u'\u767e\u5eaé\u4e00\u4e0b\uffOc\u4f60\u5c31\u77e5\u9053'] 
20180728 15:26:28.242 : INFO : 
[u' \u767e\u5ea6\u4e00\u4e0b\uf£0c\u4f£60\u5c31\u77e5\ug9053") 
20180728 15:26:28.244 : INFO : Opening url 'https://www.cnblogs.com/' 


20180728 15:26:31.021 : INFO : 
Altogether 1 item. 


1: 博客 园 - 开发 者 的 网 上 家 园 


20180728 15:26:31.021 : INFO : ${title3} = [u'\u535a\u5ba2\u56ed — 
\u5£00\u53d1\u8005\u7684\u7£51\u4e0a\ud5bb6\u56ed"] 
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20180728 15:26:31.022 : INFO : [u'\u535a\u5ba2\u56ed — 
Nu5f00Nu53d1Nu8005Vu7684Nu7f£51Nu4e0aNu5bb6Nu56ed' ] 
Ending test: RobotFrameworkTestl.TestSuite6.TestCase0016 


从 运行 的 日 志 可 以 很 清楚 地 看 到 Go Back 和 Go To 关键 字 在 使 用 时 起 到 的 效果 。 


5.1.16 Get List Items 


Get List Items 关键 字 用 来 获取 页 面 中 一 个 下 拉 列 表 中 的 所 有 下 拉 选 项 。 该 关键 字 接收 
[ locator ] 一 个 参数 ，locator 可 以 通过 id 或 者 name 等 来 进行 元 素 定 位 。 
【示例 】 我 们 以 访问 百度 贴吧 中 的 一 个 下 拉 列 表 框 为 例 来 对 该 关键 字 的 使 用 进行 说 明 , 如 
图 5-1-24 所 示 。 


€ ` C |O tiebabaiducom/i/search/advired tag 


DA 
Bai 人 贴吧 ¿e= 
只 在 此 贴吧 中 搜索 JR 搜索 | 
包含 以 下 全 部 的 关键 词 
只 搜索 该 用 户 和 发 言 例如 ;贴吧 开发 团队 


限定 搜索 结果 的 排序 方式 是 
选择 搜索 结果 显示 的 条 数 


fi 
按 相关 性 排序 


图 5-1-24 


Open Browser http://tieba.baidu.com/f/search/adv?red tag=u3387165643 
chrome 

@{Items} Get List Items name=sm 

Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0023 

20180728 23:27:16.635 : INFO : Opening browser 'chrome' to base url 
'http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 

20180728 23:27:24.714 : INFO : get attribute multiple 

20180728 23:27:24.878 : INFO : @{Items} = [ 按时 间 倒 序 | 按时 间 顺 序 | 按 相 关 性 排序 1 


Ending test: RobotFrameworkTestl.TestSuite6.TestCase0023 


5.1.17 Get Selected List Value 
Get Selected List Value 关键 字 用 于 获取 页 面 中 选中 的 一 个 下 拉 列 表 的 Value 值 。 关 键 字 接 
收 [ locator ] 一 个 参数 ，locator 可 以 通过 id 或 者 name 来 进行 元 素 定位 。 
【示例 ] 这 里 我 们 依然 以 访问 百度 贴吧 中 的 一 个 下 拉 列 表 框 为 例 来 对 该 关键 字 的 使 用 进行 
说 明 ， 如 图 5-1-25 所 示 。 


TUI 
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Baich UB ass 

ez 只 在 HR 中 搜索 ues] 

关键 同 包含 以 下 全 部 的 关 链 词 

用 户 名 只 搜索 该 用 户 的 发 言 例如 :贴吧 开发 团队 


搜索 结果 排序 方式 限定 搜索 结果 的 排序 方式 是 Beige v 
RR RR 选择 搜索 结果 显示 的 条 堵 Summi 


(x Ó] | Elements Console Sources Network Performance Memory Application Security Audits 


41--STATUS OK--》 


html 

P chead>.</head 

Y <body 

P «div ig-"com userbar" class-"u: style="z-index: 10005;"></div 
P «script type-"text/template" id-"u notif script 


M 


script type="t 
div id-"local 
«div class-"w 
Y div class="wrap2 
P ctable width="100%" border="0" cellspacing="@" cellpadding="0"-4/ti 
Y form name-"f* action onsubmit="return go where();" method="get" style-"margin:0;padding:0; 
«table width="100%" border="0" ce: ing="@" cellpadding-"@" style-"margin-top:15px;background-color:SEEEEEE"»..« /table 
«table width="100%" border-"8" c ing="@" cellspacing-"0" style-"sargin:lüpx 8 80px 0; 
v «tbody 
vite 
Petd width-"15&^ class"padfl” height-"38').(/td 
td width="208" ;限定 搜 索 结 果 的 排序 方式 是 /td 
weta 
Y select name-"sm" size«"l 


emplate" id="u_notif 
nt >a 


"¿script 


option value--0" ,按时 间 顺 序 */option 
option values"2” 48 BA REIR /option 


select 
E8 5-125 
Open Browser http://tieba.baidu.com/f/search/adv?red tag-u3387165643 
chrome 
$[(Value] Get Selected List Value name-sm 


log ${Value} 
Close Browser 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0025 

20180728 23:54:56.379 : INFO : Opening browser 'chrome' to base url 
'http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 

20180728 23:55:05.545 : INFO : get attribute multiple 

20180728 23:55:05.599 : INFO : get attribute value 

20180728 23:55:05.609 : INFO : ${Value} = 1 

20180728 23:55:05.610 : INFO : 1 


Ending test: RobotFrameworkTest1.TestSuiteé.TestCase0025 
从 运行 结果 看 ， 刚 好 与 我 们 通过 浏览 器 的 开发 工具 看 到 的 value 值 完全 一 致 ， 如 图 5-1-26 
所 示 。 
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|v «tbody 
vetr 


<td width="15%" class-"padfl" height="30">.</td: 
td width="28x%"; 限 定 搜索 结果 的 排序 方式 是 </td 
v «td: 


V<select name-"sm" size-"l 


option value="9” 按时 间 顺 序 </option 

option value="2") 按 相关 性 排序 </option 
/select 

jtd 


图 5-1-26 


5.1.18 Select From List 


Select From List 关键 字 用 来 模拟 从 指定 的 下 拉 列 表 中 选择 指定 的 下 拉 列表 选项 ,该 关键 字 
接收 [locator | *items ] 多 个 参数 ，locator ATLA id, name 来 进行 元 素 的 定位 。 当 列表 中 传 入 
多 个 值 时 , 默认 选择 最 后 一 条 , 如 果 传 入 的 是 一 个 空 列表 , 就 会 默认 选择 这 个 列表 中 的 所 有 值 。 
【示例 】 这 里 我 们 继续 访问 百度 贴吧 ， 目 标 是 通过 Select From List 关键 字 选 中 
TERE) 这 个 选项 。 我 们 通过 浏览 器 的 开发 者 工具 可 以 看 到 GRR) 这 个 选项 对 
应 的 value 为 2， 所 以 我 们 在 关键 字 的 参数 中 传 入 的 参数 为 2 ， 如 图 5-1-27 所 示 。 


Open Browser http://tieba.baidu.com/f/search/adv?red tag-u3387165643 
chrome 


Select From List name-sm 2 
sleep 5 
Close Browser 


C | tieba.baidu.com/f/search/adv?red tag-u3387165643 


ote, 

Baid BE ¿sis 

eg 只 在 tm 中 搜索 Ra 搜寻 

关键 词 包含 以 下 全 部 的 关键 词 

用 户 名 只 搜索 该 用 户 的 发 言 例如 :贴吧 开发 团队 
搜索 结果 排序 方式 限定 搜索 结果 的 排序 方式 是 PAME " 

搜索 结果 蜡 示 条 教 选择 执 索 结果 显示 的 条 教 SARDOR Y 

[X ü] Elements Console Sources Network Performance Memory Application Security Audits 


<1--STATUS OK--> 
html. 
> ¿head /head 


ng="@" cellpadding-"@">— 
onsubmit-"return go_wnere();~ method="g 
> ctable width="100%" border-"0" celispacing="@" cellpaóding-"0" s! 


margin: @;padding:@; 
-top: 15px; background-color :#EEEEEE" »..</table 
margin:10px 0 B6px 0; 


Y tbody 
vite 
P ctd width="15%" class="padfl” height-730'».«/td: 
td ddth- 298 "限定 搜索 结果 的 排序 方式 是 </td 
vita 


Y select name-"sm" size="1' 
option value="l”selected) 按 时 间 侧 序 </option 
option value-"8” ;按时 间 顺 序 </option; 


5-1-27 
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运行 结果 如 下 : 


Starting te 
20180729 09 


st: RobotFrameworkTestl.TestSuite6.TestCase0031 
253:40.279 : INFO : Opening browser 'chrome' to base url 


'"http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 


20180729 09 
20180729 09 
20180729 09 
Ending test 


253:49.543 : INFO : Selecting option(s) '2' from list 'name-sm'. 
:53:49.582 : INFO : get attribute multiple 

153:54.675 : INFO : Slept 5 seconds 

: | RobotFrameworkTestl.TestSuite6.TestCase0031 


从 实际 执行 的 效果 看 ， 已 经 可 以 成 功 选中 这 个 列表 ， 如 图 5-1-28 所 示 。 
€ > C [D tebabaiduconyt/se = «Im 
| chrome ESEE RRR, x| 
of, Eman nz ss usus W22- 
Bai RUE suma LS 
m arimea meee) 
xwa Bauteam 
用 户 各 | Sii ETON 
eae LE eae) 
MEXATIAÉO — 过 民政 现下 和 BRETT 


«cs MIEN | REED | EAE | moist | FUNT 


图 5-1-28 


5.1.19 Selenium2Library 库 其 他 的 自动 化 测试 关键 字 介绍 


表 5-1-4 4 


关键 字 


Page Should 
Contain 


P 介 绍 了 Selenium2Library 库 中 剩余 的 其 他 关键 字 的 用 法 。 
3k 5-1-4 Selenium2Library 库 中 其 他 关键 字 的 用 法 
使 用 描述 
该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包含 了 指定 的 文本 内 容 ， 接 收 [ text | loglevel=INFO ] 两 


个 参数 ， 如 果 不 传 入 日 志 级 别 时 ， 默 认 loglevel=INFO。 示 例 : 
Page Should Contain Robot Framework 


Page Should 
Contain Button 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包含 了 指定 的 Button 按钮 ， 接 收 [ locator | message= | 

loglevel=INFO ] 三 个 参数 ， 和 Page Should Contain 关键 字 的 使 用 方式 很 类 似 ，locator 参数 可 

以 通过 id. name. value 等 来 进行 元 素 定位 。 示 例 : 

| Open Browser http://www.baidu.com chrome | 

| Page Should Contain Button | id-su 包含 “百度 一 下 ”按钮 | 
Close Browser 
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第 5 章 ，Web 自动 化 测试 


(BER) 


关键 字 使 用 描述 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包 含 了 指定 的 Checkbox 选项 ， 接 收 [ locator | message= 
loglevel=INFO ] 三 个 参数 ， 和 Page Should Contain Button 非常 类 似 ，locator 参数 可 以 通过 
id, name 来 进行 元 素 定位 。 示 例 : 


Page Should Open Browser https://passport.cnblogs.c | chrome 
Contain om/user/signin?ReturnUrl 
Checkbox —https%3A%2F%2Fwww 
-cnblogs.com%2F 
Page Should Contain Checkbox | id=remember_me 包含 “下 次 自动 登录 ”选项 
Close Browser 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包 含 了 指定 的 Element 元 素 ， 接 收 [ locator | message= 
Page Should loglevel=INFO ] 三 个 参数 ， 和 上 面 的 Page Should Contain Checkbox 关键 字 非 常 类 似 ，locator 
a 参数 可 以 通过 这 、name 来 进行 元 素 定位 。 示 例 : 

Element Page Should Contain Element | itsiain | 包含 了 指定 的 元 素 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包含 了 指定 的 Image 图 片 元 素 ， 接 收 [ locator 
message- | loglevel=INFO ] 三 个 参数 ， 和 上 面 的 几 个 关键 字 类似 ，locator 参数 可 以 通过 id, 
src、alt 来 进行 元 素 的 定位 。 

【示例 1] locator 通过 src 来 定位 : 

Open Browser chrome 

Page Should Contain Image | https://box.bdimg.com/static/fisp_st | 包含 “指定 的 图 片 ” 
atic/common/img/searchbox/logo n 

‘Contain image ews 276 88 119876 png 


Close Browser 


Page Should 


http://news.baidu.com/ 


Page Should Contain Image | 百度 新 闻 包含 “指定 的 图 片 ” 


Close Browser 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包 含 了 指定 的 Link 元 素 ， 接 收 [ locator | message= 
loglevel-INFO ] 三 个 参数 ， 和 上 面 的 几 个 关键 字 类 似 ，locator 参数 可 以 通过 id, name, href, 
Page Should |link text 来 进行 元 素 的 定位 ， 这 里 以 href 的 定位 方式 来 作为 示例 : 

Contain Link Open Browser hittp://www.baidu.com chrome 

Page Should Contain Link http://news.baidu.com. 包含 “指定 的 link” 


Close Browser 
该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包 含 了 指定 的 List, i locator | message= 
Rage should loglevel=INFO ] 三 个 参数 ，locator 参数 可 以 通过 id, name 来 进行 定位 。 示 例 : 
Contain List 
Page Should Contain List id-pf. 包含 正确 
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Robot Framework 自动 化 测试 框架 核心 指南 


(BER) 


关键 字 


使 用 描述 


Page Should 
Contain Radio 
Button 


Page Should 
Contain 
Textfield 


Capture Page 
Screenshot 


Set Screenshot 
Directory 
Checkbox 


Should Be 
Selected 


Clear Element 
Text 


Click Image 


Close Window 


Confirm Action 


该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包含 了 指定 的 被 选中 的 按钮 ， 接 收 [locator | message= 
loglevel=INFO ] 三 个 参数 ，locator 参数 可 以 通过 id. name, value 来 进行 定位 。 示 例 : 
Page Should Contain Radio Button | name-sw f | 包含 正确 

该 关键 字 用 来 判断 当前 窗口 页 面 是 否 包 含 了 指定 的 文本 字段 ， 接 收 [ locator | message= 
loglevel=INFO ] 三 个 参数 ，locator 参数 可 以 通过 Id, name 来 进行 元 素 的 定位 。 示 例 : 

Page Should Contain Textfield | name-syt 

该 关键 字 主 要 用 来 在 自动 化 运行 过 程 中 对 当前 的 屏幕 进行 截图 ， 便 于 在 自动 化 执行 过 程 中 
遇 到 问题 时 通过 截图 的 方式 保存 运行 报错 时 的 现场 。 该 关键 字 接 收 [ flename=None ] 一 个 参 
数 ， 可 以 指定 保存 的 文件 的 名 称 。 示 例 : 

Capture Page Screenshot Test.pn; 
该 关键 字 用 来 设置 快照 保存 的 目录 ， 接 收 [ path | persist-False ] 两 个 参数 。 可 以 和 Capture 
Page Screenshot 配合 使 用 。 示 例 : 

Set Screenshot Directol dX 
该 关键 字 主要 用 来 判断 指定 的 Checkbox 是 否 被 选中 ， 接 收 [ locator ] 一 个 参数 。locator 参数 
可 以 通过 id、name 来 进行 元 素 的 定位 。 示 例 : 

Checkbox Should Be Selected 

该 关键 字 主 要 用 来 清空 文本 框 中 的 内 容 ， 接 收 [locator ] 一 个 参数 。 示 例 : 

Clear Element Text id=kw 

该 关键 字 用 来 模拟 单 击 某 一 个 图 片 ， 接 收 [ locator ] 一 个 参数 。locator 可 以 通过 id、src、alt 

来 进行 定位 。 示 例 : 

Click Image https://box.bdimg.com/static/fisp_static/common 
/img/searchbox/logo news 276 88 1f9876a.pny 

该 关键 字 用 来 关闭 当前 的 窗口 ， 不 需要 接收 任何 参数 


该 关键 字 用 来 获取 确认 对 话 框 中 对 应 的 确认 信息 ， 不 需要 接收 任何 参数 ， 示 例 : 


Click Button 
${confirmmessage}= Confirm Action 


log ${confirmmessage} 


Current Frame 
Contains 


该 关键 用 来 判断 当前 的 Frame 中 是 否 包含 指定 的 文本 内 容 ， 接 收 [ text | loglevel=INFO ] 两 个 
参数 ， 示 例 : 
Current Frame Contains | 指定 的 内 容 信 息 


Double Click 
Element 


该 关键 字 用 来 模拟 双击 操作 ， 接 收 [locator] 一 个 关键 字 。locator 可 以 通过 id 或 者 name 来 进 
行 定位 。 示 例 : 
Double Click Element | Id=iwe 
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#5= Web 自动 化 测试 


(BER) 


关键 字 使 用 描述 


该 关键 字 用 来 模拟 拖 电 操 作 接收 [ source | target ] 两 个 参数 source 和 target 都 是 通过 locator 
Drag And Drop | 定位 到 具体 元 素 。 示 例 
Drag And Drop elementA. | elementB 


该 关键 字 同 样 是 用 来 模拟 拖 外 操作 ， 接 收 [ source | xoffset | offset ] 三 个 参数 ，source 就 是 通 
Drag And Drop | 过 locator 定位 到 的 具体 元 素 。 该 关键 字 的 作用 是 将 source 元 素 拖 电 到 一 个 具有 x. y 坐标 
By Offset 标志 的 位 置 。 示 例 ; 

Drag And Drop By Offset | clement | 100 | -40 


该 关键 字 用 来 判断 定位 到 的 某 个 元 素 是 否 开启 。 该 关键 字 接收 [ locator ] 一 个 参数 ，locator 
可 以 通过 i 或 者 name 来 进行 定位 。 示 例 : 

Element Should Be Enabled id=pwa 

sad| 该 关键 字 用 来 判断 定位 到 的 某 个 元 素 的 属性 是 否 是 可 见 的 。 该 关键 字 接收 [ locator | 
Element Should) message= ] 两 个 参数 ，locator 可 以 通过 这 或 者 name 来 进行 定位 。 示 例 : 


Be Visible = 
Element Should Be Visible 


该 关键 字 用 来 判断 定位 到 的 某 个 元 素 的 内 容 中 是 否 包含 指定 的 内 容 。 该 关键 字 接收 [locator 
Element Should|| ced | message= ] 三 个 参数 ，locator 可 以 通过 i 或 者 name 来 进行 定位 。 示 例 ; 


Contain 
Element Should Contain 包含 的 指定 内 容 


该 关键 字 用 来 判断 定位 到 的 某 个 元 素 中 的 文本 内 容 是 否 和 指定 的 期 望 的 内 容 完全 一 致 。 节 
Element — Text | XEF HKI locator | expected | message- ] 三 个 参数 ，locator 可 以 通过 id 或 者 name 来 进 4 
Should Be 定位 ，message 可 以 用 来 覆盖 指定 的 提示 信息 。 示 例 : 


Element Should 
Be Enabled 


s£ 


i 


Element Text Should Be 指定 的 内 容 
Get Alert | 该 关键 字 用 来 获取 一 个 JavaScript alert 确认 弹出 框 对 应 的 提示 信息 。 该 关键 字 接 收 
Message dismiss=True ] 一 个 参数 ， 如 果 不 传 入 参数 ， 默 认 dismiss=True 

è 该 关键 字 用 来 获取 某 个 Cookie 的 值 接收 [name ] 一 个 参数 .这 里 的 name 参数 指 的 是 Cookie 
Get Cookie = 
的 名 称 。 示 例 : 

Value 

Get Cookie Value Book 


该 关键 字 和 之 前 的 Input Text 关键 字 类 似 ， 不 同 的 是 由 于 密码 具有 私密 性 ， 因 此 在 Robot 
Framework 运行 日 志 输 出 时 不 会 直接 输出 密码 到 日 志 中 。 该 关键 字 接收 [ locator | text ] 两 个 


Input Password | 参数 locator 可 以 通过 过 或 者 name 来 进行 元 素 定位 text 参数 代表 需要 输入 的 密码 . 示例 ， 
Input Password id=kw 123456 
该 关键 字 用 于 获取 当前 窗口 页 面 访问 的 路 径 ， 不 需要 接收 任何 参数 。 示 例 : 
Browser http://www.baidu.com chrome 
Get Location ${Location} Get Location 


log $ {Location} 
Close Browser 
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Robot Framework 自动 化 测试 框架 核心 


(BER) 


关键 字 


使 用 描述 


Get Matching 
Xpath Count 


该 关键 字 用 来 统计 通过 某 个 xpath 匹配 到 具体 元 素 的 数量 ,在 我 们 排除 自动 化 错误 时 十 分 有 
Ak. 通过 一 个 xpath 能 匹配 到 多 个 元 素 时 ， 经 常会 引起 自动 化 报错 ， 使 用 该 关键 字 可 以 很 快 
发 现 一 个 xpath 是 否 会 定位 到 多 个 元 素 。 该 关键 字 接 收 [xpath ] 一 个 参数 。 示 例 : 
S${count} Get Matching Xpath Count //*|@id="u1"]J/a[1] 


lo; S (count 


Get Selected 
List Label 


Get Selected 
List Labels 


Get Selected 
List Values 


该 关键 字 用 来 获取 已 经 选择 的 下 拉 列 表 的 Label 标签 值 ， 接 收 [ locator ] 一 个 参数 。locator 
可 以 通过 id 或 者 name 来 进行 元 素 的 定位 。 示 例 : 
http://tieba baidu.com/f/search/ 
adv?red_tag=u3387165643 


Get Selected List Label 


$(label 


Open Browser chrome 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0024 
20180728 23:47:47.576 : INFO : Opening browser 'chrome' to base url 
'http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 
20180728 23:47:55.213 : INFO : get attribute multiple 

20180728 23:47:55.290 : INFO : ${label} = 按时 间 倒序 

20180728 23:47:55.292 : INFO : 按时 间 倒序 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0024 


该 关键 字 和 Get Selected List Label 类 似 ， 不 同 的 是 该 关键 用 来 获取 已 经 选择 的 多 个 列表 的 
标签 值 适合 于 多 选 的 情况 。 该 关键 字 接收 [locator ] 一 个 参数 locator 可 以 通过 id 或 者 name 
来 进行 元 素 的 定位 。 示 例 : 

ame-sm 


S (labels 


该 关键 字 和 Get Selected List Value 关键 字 类 似 ， 不 同 的 是 Get Selected List Values 适合 获取 
多 选 下 拉 列 表 框 中 的 Value 值 。 该 关键 字 接收 [ locator ] 一 个 参数 ，locator 可 以 通过 id 或 者 
name 等 来 进行 元 素 定位 。 示 例 : 


Open Browser http://tieba.baidu.com/f/search | chrome 
/adv?red tag-u3387165643 
| Q (Value) Get Selected List Values name-sm 
Close Browser 
运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0026 


20180729 00:07:12.416 : INFO : Opening browser 'chrome' to base url 
'http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 
20180729 00:07:21.235 : INFO : get attribute multiple 

20180729 00:07:21.312 : INFO : get attribute value 

20180729 00:07:21.320 : INFO : @{Value} = [ 1 ] 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0026 
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$8538 Web 自动 化 测试 


(BER) 


关键 字 使 用 描述 


该 关键 字 用 来 获取 Selenium 运行 的 速度 ， 在 做 自动 化 框架 运行 性 能 监控 以 及 性 能 调 优 分 析 
Get Selenium | 时 非常 有 用 ， 不 需要 接收 任何 参数 。 示 例 : 

Speed S{speed} Get Selenium Speed 
lo; $ís 


该 关键 字 用 来 获取 Selenium 运行 出 现 超时 的 超时 时 间 ， 在 做 自动 化 框架 运行 性 能 监控 以 及 
Get Selenium | 性 能 调 优 分 析 时 非常 有 用 ， 不 需要 接收 任何 参数 。 示 例 : 


Timeout S (time Get Selenium Timeout 
log $ (time) 


EJ 
El 


该 关键 字 用 来 获取 当前 页 面 窗口 的 坐标 位 置 ， 先 返 
任何 参数 。 示 例 : 


横 坐 标 ， 再 返 


纵 坐 标 ， 不 需要 接收 


Open Browser http://tieba.baidu.com/f/seare | chrome 


h/adv?red tag-u3387165643 


[Hw ,xs | 
[sy CC C O 0 0 | 


Get Window 
Position 


Get Window Position 


Close Browser 


该 关键 字 用 来 获取 当前 页 面 窗口 的 大 小 ， 会 返回 窗口 的 宽 和 高 两 个 值 ， 先 返 
高 度 ， 不 需要 接收 任何 参数 。 示 例 : 
Open Browser http://tieba.baidu.com/f/searc 
h/adv?red tag-u3387165643 
Get Window Size 


El 


宽度 ， 再 返 


El 


Get Window || Close Browser 

Size 运行 结果 如 下 : 

Starting test: RobotFrameworkTestl.TestSuite6.TestCase0028 
20180729 00:25:13.981: INFO : Opening browser 'chrome' to base url 
'http://tieba.baidu.com/f/search/adv?red tag-u3387165643' 
20180729 00:25:23.873 : INFO : ${width} = 1050 

20180729 00:25:23.873 : INFO : ${height} = 840 

20180729 00:25:23.875 : INFO : 1050 

20180729 00:25:23.876 : INFO : 840 

Ending test: RobotFrameworkTestl.TestSuite6.TestCase0028 


该 关键 字 用 来 获取 当前 打开 的 所 有 页 面 窗口 ， 不 需要 接收 任何 参数 ， 返 回 的 结果 是 一 个 列 
表 的 形式 。 示 例 : 


: " Open Browser http://tieba.baidu.com/f/seare | chrome 
List Windows 
l/adv?red tag-u3387165643 
@ {result} List Windows 


Close Browser 
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Robot Framework 自动 化 测试 框架 核心 指南 


(BER) 


关键 字 


使 用 描述 


Mouse Down 


Mouse Up 


Mouse Down 
On Image 


Mouse Down 
On Link 


Mouse Out 


Reload Page 


Register 
Keyword To 
Run On Failure 


该 关键 字 用 来 模拟 按 下 鼠标 的 左 键 操作 接收 [locator ] 一 个 参数 locator 可 以 通过 这 和 mame 
来 进行 元 素 的 定位 。 示 例 : 

Mouse Down | id=kw | 
该 关键 字 和 Mouse Down 刚好 相反 ， 用 来 释放 按 下 的 鼠标 左 键 。 该 关键 字 接收 [ locator ] 一 
ASB locator 可 以 通过 id 和 name 来 进行 元 素 的 定位 。 示 例 : 

Mouse Up [ id=kw | 

该 关键 字 用 来 模拟 在 页 面 上 的 一 张 图 片上 按 下 鼠标 的 左 键 操作 ， 该 关键 字 接收 [ locator ]— 

ASB locator 可 以 通过 id、src、alt 来 进行 元 素 的 定位 。 示 例 : 

Mouse Down On Image https://box.bdimg.com/static/fisp static/common/img/searchbo 
X/logo news 276 88 1f9876a.pn; 


该 关键 字 用 来 模拟 在 页 面 上 的 一 个 链接 上 按 下 鼠标 左 键 的 操作 。 该 关键 字 接收 [ locator ]— 
ASH, locator 可 以 通过 id、href、link text 来 进行 元 素 的 定位 。 示 例 : 

Mouse Down On Link http://map.baidu.com 

该 关键 字 用 来 模拟 鼠标 离开 页 面 上 的 一 个 元 素 的 操作 。 该 关键 字 接收 [ locator ] 一 个 参数 ， 
locator 可 以 通过 id, name 来 进行 元 素 的 定位 。 示 例 : 


https://www.baidu.com/ 


Mouse down id=kw 


Mouse Out 
Close Browser | | 


该 关键 字 用 来 模拟 重新 加 载 当前 窗口 的 页 面 ， 不 需要 接收 任何 参数 


该 关键 字 用 来 模拟 自动 化 案例 执行 失败 时 需要 执行 的 操作 。 比 如 某 个 案例 执行 失败 后 浏览 
器 并 没有 关闭 ， 此 时 需要 在 失败 时 将 浏览 器 关闭 ， 就 可 以 用 这 个 关键 字 来 操作 。 该 关键 字 
接收 [ keyword ] 一 个 参数 ，keyword 表示 执行 失败 时 需要 执行 的 关键 字 操 作 ， 就 是 我 们 常 说 
的 容错 操作 。 示 例 : 


Open Browser 


https://www.baidu.com/ 
| CioseBrowser | | 


Mouse down 


Close Browser 
运行 结果 如 下 : 
Starting test: RobotFrameworkTestl.TestSuite6.TestCase0030 
20180729 09:31:02.645 : INFO : Opening browser 'chrome' to base url 
'https://www.baidu.com/"' 

20180729 09:31:10.295 : INFO : Close Browser will be run on failure. 
20180729 09:31:10.296 : INFO : Simulating Mouse Down on element 'id-kwlll" 
20180729 09:31:11.472 : FAIL : ERROR: Element id-kw111 not found. 
Ending test: ^ RobotFrameworkTestl.TestSuite6.TestCase0030 


从 运行 结果 看 ， 当 通过 id=kw111 定位 不 到 对 应 的 元 素 时 执行 就 失败 了 ， 但 是 由 于 我 们 在 第 
二 步 中 做 了 Register Keyword To Run On Failure 容错 操作 ， 所 以 就 算 执行 失败 了 也 可 以 将 浏 


览 器 正常 关闭 掉 
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$8538 Web 自动 化 测试 


(BER) 


关键 字 使 用 描述 


该 关键 字 用 来 模拟 选择 表单 中 的 所 有 列表 。 该 关键 字 接 收 [ locator ] 一 个 参数 ，locator 可 以 


Select All From 通过 这 、name 来 进行 元 素 的 定位 。 示 例 : 


List 
Select All From List id=aac 
SB 该 关键 字 用 来 模拟 选择 一 个 Checkbox 的 操作 。 该 关键 字 接收 [ locator ] 一 个 参数 ，locator 可 
S 以 通过 id、name 来 进行 元 素 的 定位 。 示 例 : 
Checkbox 


Select Checkbox | id=box 


该 关键 字 用 来 模拟 通过 下 拉 列 表 的 Index 来 选中 指定 的 下 拉 列 表 的 选项 ， 该 关键 字 接 收 
Select ”From |[ locator | *indexes ] 多 个 参数 ，locator 可 以 通过 id, name 来 进行 元 素 的 定位 ，indexes 可 以 

List ByIndex | 允许 传 入 多 个 。 示 例 ; 

Select From List By Index name-sm 0 


该 关键 字 用 来 模拟 通过 下 拉 列 表 的 Label 来 选中 指定 的 下 拉 列 表 的 选项 。 该 关键 字 接 收 
Select From List| [ locator | *labels]£ 4» 223, locator 可 以 通过 id, name 来 进行 元 素 的 定位 ，labels 可 以 允许 
By Label 传 入 多 个 。 示 例 : 


Select From List By Label 按时 间 顺 序 


该 关键 字 用 来 模拟 通过 下 拉 列 表 的 Value 值 来 选中 指定 的 下 拉 列 表 的 选项 ，Value 值 可 以 通 
Select From List | 过 浏览 器 的 开发 者 工具 操作 来 获得 。 该 关键 字 接 收 [locator | *values] 多 个 参数 ，locator 可 以 
By Value 通过 id、name 来 进行 元 素 的 定位 ，values 可 以 允许 传 入 多 个 。 示 例 ， 
Select From List By Value 1 


Select Window 关键 字 用 来 模拟 打开 了 多 个 页 面 窗口 时 在 不 同 的 窗口 之 间 进 行 窗口 切换 的 操 
作 。 该 关键 字 接 收 [locator=None ] 一 个 参数 locator 可 以 是 name 窗口 title url, window handle 


等 。 示 例 : 
Select Window Open Browser http://www.baidu.com 


Click Link name-tj trmap 


Select Window 百度 地 图 

Close Browser | | 
该 关键 字 用 来 设置 一 个 Selenium 操作 时 的 超时 时 间 ， 避 免 一 直 循环 等 待 ， 导 致 其 他 的 测试 
用 例 无 法 继续 执行 ， 接 收 [ seconds ] 一 个 参数 。 示 例 : 


Set — Selenium 
Timeout 


Set Selenium Timeout 5 
, 该 关键 字 用 来 模拟 表单 的 提交 操作 ， 接 收 [locator=None ] 一 个 参数 。 示 例 : 
Submit Form T j 
Submit Form id=form1 
该 关键 字 用 来 模拟 打开 了 多 个 浏览 器 后 在 多 个 浏览 器 中 的 切换 操作 ， 接 收 [ index or alias ] 
一 个 参数 。 示 例 : 
Open Browser http://www.baidu.com 
Switch Browser || Location Should Be https://www.baidu.com | 
Open Browser https://www.cnblogs.com/ | ie 
Switch Browser T 


Close All Browsers 
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(BER) 


关键 字 


使 用 描述 


Table 


Table 


Wait 
Element 
Contains 


Xpath 
Match X 


5.2.1 


WebDriver 那样 通过 查找 元 素 的 方式 去 对 页 面 进行 定位 ， 而 是 使 用 屏幕 截图 的 方式 来 定位 页 面 


Cell 


Should Contain 


Header 


Should Contain 


Until 


Should 
Times 


该 关键 字 用 来 判断 表格 中 指定 的 字段 中 是 否 包含 期 望 的 内 容 。 该 关键 字 接收 [ table locator 
row | column | expected | loglevel-INFO ] 五 个 参数 ， 其 中 row 和 column 参数 都 是 从 1 开始 
的 。 示 例 : 

Table Cell | tableelement 1 1 
Should 

Contain 


该 关键 字 用 来 判断 表格 中 的 表 头 是 否 包含 指 定 的 内 容 ， 接 收 [ table locator | expected 


robot 


loglevel=INFO ] 三 个 参数 。 示 例 : 
Table Header Should | tableelement robot 
Contain 


该 关键 字 用 来 模拟 等 待 页 面 中 加 载 到 指定 的 内 容 时 才 做 后 面 的 操作 ， 防 止 页 面 窗口 没有 完 
全 加 载 完成 就 执行 接 下 来 的 关键 字 操 作 ， 从 而 导致 操作 失败 。 该 关键 字 接收 [ locator | text 
timeout-None | error-None ] 四 个 参数 。 示 例 : 


i ie iiis i 
Contains 


该 关键 字 用 来 判断 某 个 xpath 路 径 可 以 匹配 到 的 次 数 ， 是 一 个 断言 关键 字 ， 接 收 [ xpath 
expected xpath count | message- | loglevel=INFO ] 四 个 参数 ， 示 例 : 


Xpath Should Match X | //*[@id="form")/span[1]/s | 1 
Times pan 


SikuliLibrary 库 的 使 用 


Sikuli 简介 


Sikuli 是 一 种 图 形 化 编程 技术 ， 或 者 也 可 以 说 是 一 种 图 形 化 的 自动 化 测试 工具 ， 平 时 在 屏 
幕 上 看 到 的 任何 画面 ，Sikuli 都 可 以 使 用 图 像 识别 的 方式 来 进行 操作 。Sikuli 不 需要 像 


的 按钮 等 ，Sikuli 用 于 自动 化 测试 的 优点 如 下 : 

可 以 测试 不 易 识 别 或 无 法 定位 的 对 象 ， 比 如 地 图 Flash 和 图 表 等 。 

可 以 验证 和 识别 图 片 。 

直接 对 图 片 进行 操作 ， 更 加 通俗 易 懂 ， 容 易 维 护 。 

适用 于 Window/Linux/Mac OS X 桌面 应 用 ， 甚 至 是 iPhone 和 Android 模拟 器 的 自动 
化 测试 。 
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e ”对 于 相似 的 图 片 或 者 按钮 容易 识别 错误 。 
e 由 于 只 能 对 图 像 进行 操作 ， 因 此 不 够 灵 
WebDriver 进行 Web 自动 化 测试 。 


， 一 般 只 能 用 于 辅助 测试 ， 比较 适合 于 辅助 


通过 访问 https://github.com/sikuli/sikuli 网 址 可 以 进入 sikuli 的 GitHub 中 获取 最 新 版 本 的 
sikuli， 如 图 5-2-1 所 示 。 


Q |& 安全 | https//githubcom/sikuli/sikul & + 


O Why GitHub? ~ Business Explore ~ Marketplace Pricing Signin | Sign up | 


E sikuli / sikuli Owatch 180 — WStar 1529 | YFork | 288 
€) Code ssues 0 ull requests 0 Projects 0 Wiki Insights 
Join GitHub today 
GitHub is home to over 28 million developers working together to host [9] 


and review code, manage projects, and build software together. 


Sikuli's official repository on github. Ask questions or report bugs at http//launchpad.net/sikuli. http://sikuliorg 


© 1.296 commit: V 3 branche 0 release 4 10 contributor ab MIT 
ANGUS mn == 
lig design. 'eated scratch-sik 
图 52-1 


5.2.2 SikuliLibrary 的 使 用 


通过 访问 GitHub 地 址 https://github.com/rainmanwy/robotframework-SikuliLibrary 可 以 下 载 
和 安装 robotframework-SikuliLibrary 库 ， 如 图 5-2-2 所 示 。 
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€ C | @ 安全 | https://github.com/rainmanv 


O Why GitHub? Business Explore - Marketplace Pricing Sgnin | sign up | 


E rainmanwy / robotframework-SikuliLibrary Owan | 16 | [sse | 5: | | Vrox | 35 
«> Code Pull requests 0 Projects 0 Insights 
= es Dismiss 
Join GitHub today 
GitHub is home to over 28 million developers working together to host [9] 


and review code, manage projects. and build software together. 


Sikuli Robot Framework Library provide keywords for Robot Framework to test UI through Sikuli. 


(D 123 commits V 2 branches 


44.3 contributors db Apache-20 


Branch: master v Find file 


fia demo add drag drop and de 
lig docs 


i src 


图 5-2-2 


也 可 以 通过 pip install robotframework-SikuliLibrary 来 进行 在 线 安 装 。 安 装 完成 后 ， 在 使 


用 时 需要 在 RIDE 中 导入 SikuliLibrary 库 ， 如 图 5-2-3 所 示 。 

| Edit | Text Edit | Run | Log 

TestSuite15 

Source F:\project\RobotFrameworkTest1 \RobotFrameworkTest1 \ TestSuite15.txt 
Import Name / Path Arguments Comment 

Library SikuliLibrary 

Library Selenium2Library 


图 5-2-3 


【示例 1】 使 用 WebDriver 和 sikuli 结合 的 方式 来 模拟 单 击 百度 首页 进行 搜索 。 
截取 百度 首页 的 搜索 图 标的 图 片 , 并 且 放 入 指定 的 磁盘 位 置 , 比如 放 入 到 本 地 电脑 磁盘 D 
盘 的 根 目 录 下 ， 如 图 5-2-4 所 示 ， 然 后 在 使 用 Click 关键 字 时 将 传 入 D 盘 根 目 录 下 的 apng 的 
路 径 作 为 该 关键 字 的 参数 。 


130 


第 5 章 ，Web 自动 化 测试 


— = 


| 


BOS "an, sae 0) > 


图 5-2-4 


使 用 SikuliLibrary 中 的 Click 关键 字 来 模拟 单 击 百度 首页 的 Bait 图 标 ， 然 后 看 一 下 
单 击 后 的 效果 ， 如 图 5-2-5 所 示 


http://www.baidu.com 


图 5-2-5 
运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuitel5.TestCase0001 

20181202 17:59:37.594 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com" 

20181202 17:59:52.316 : INFO : Params: [d:\a.png] 


20181202 17:59:52.316 : INFO : 

«img src-'sikuli captured/sikuliximage-1543744791279.png'/» 
[log] CLICK on L(534,294)@S(0) [0,0 1600x900] (524 msec) 
Ending test: | RobotFrameworkTestl.TestSuitel5.TestCase0001 


从 运行 结果 可 以 看 到 ， 通 过 Click d:\\a.png 的 方式 执行 的 效果 和 通过 WebDriver 中 的 
xpath= //*[@id="lg"]/map/area 执行 的 效果 完全 一 样 ， 如 图 5-2-6 和 图 5-2-7 所 示 。 


Sart 六 
€ > O | e == [nitpy//www bolducom wm | 


Mp sin em sa me zt RT sa EIE 


e 
Baicb 百度 


5-2-6 
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人 he 


C | @ == | nttps//www.baidu.com/s?wd= ttn=SE PclogoS Swhnvm25&sa-ire di gh logo&rsv di-igh logo pc tr| E 


Bai@ae 今日 新 记事 © ES Ezam sE- 22 


网 页 资讯 WR 知道 TA aR BH ME x= ms 


2018 年 12 月 2 日 星期 日) 


废除 奴隶 制 国际 日 


INSI2BIBEUSSGISSIERH. SHSOREIERH 
(Intemational Day for the Abolition of Slavery)... BEES 


k 


今日 新 鲜于 搜索 热点 EUST 
SHAE SHAE tone 
Eb 12 分 入 4 次 让座 
S299 ERIE Se FERRE Tee AAR 
B GBEE EE-E eR T RT 


加 SERRTAIE 
E ERE t 
T) BEER T 
B Re El WES 365296 4 
EE 
http /hcp baidu com/?fyb=Pe ReDianAiaD1 + 
百度 新闻 一 一 全 球 最 大 的 中 文 新 闻 王 台 
BUEWRREAEBERISNES Ti ROS SHERINTIA 

À, LURRR, AAEN., ADIS, HRT 

De FUH) ee m. - 


5-2-7 


【示例 2 使 用 SikuliLibrary 中 的 Get Match Score 关键 字 来 从 屏幕 上 获取 指定 目标 图 像 的 
匹配 度 ， 这 里 依旧 采用 【示例 1】 中 的 图 像 作为 待 匹配 的 目标 图 像 ， 如 图 5-2-8 所 示 。 
Open Browser http://www.baidu.com chrome 


Is (score) Get Match Score d:Wa.png 
g $(score) 


图 5-2-8 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuitel5.TestCase0002 

20181202 20:39:56.115 : INFO : Opening browser 'chrome' to base url 
'http://www.baidu.com" 

20181202 20:40:09.648 : INFO : Params: [d:\a.png] 

20181202 20:40:09.648 : INFO : «img 

src-'sikuli captured/sikuliximage-1543754409621.png'/» 

20181202 20:40:09.648 : INFO : ${score} = 1.0 

20181202 20:40:09.649 : INFO : 1.0 

Ending test: RobotFrameworkTestl.TestSuitel5.TestCase0002 


从 运行 结果 可 以 看 到 , 由 于 屏幕 上 的 百度 首页 中 存在 和 目标 图 片 一 致 的 图 像 , 所 以 最 终 获 
取 到 的 匹配 度 为 1.0， 说 明 为 完全 匹配 ， 如 图 5-2-9 所 示 。 
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5.2.3 SikuliLibrary 的 工作 原理 


如 图 5-2-10 所 示 ，Robot Framework 的 SikuliLibrary 库 和 Sikuli 之 间 的 通信 关系 如 下 ， 
借助 Robot Framework 提供 的 XML-RPC 协议 的 Remote 服务 进行 通信 ,通过 Remote 调用 方式 
来 连接 用 Java 语言 实现 的 Sikuli API 操作 , 正 是 由 于 有 了 XML-RPC 协议 的 远程 调用 , 使 得 不 
管 是 Python 语言 、Java 语言 或 者 其 他 语言 都 可 以 调用 Sikuli 的 Java API。 关 于 Remote 的 调用 
方式 ， 在 后 面 还 会 继续 详细 讲解 。 


Robot FrameWork Robot FrameWork 
测试 案例 Library(Python Client) 

xm 
rpe | | Jrobot Remote sikuli Sikuli 

Java Client e Server Keywords Java API F ww 

其 它 语言 的 

Client 
5-2-10 


另外 ,从 SikuliLibrary 的 源码 中 我 们 也 可 以 分 析出 其 调用 的 方式 ,在 SikuliLibrary 的 Python 
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T 


源码 sikulipy 中 有 如 下 几 个 重要 的 Python 函数 ， init. 函数 中 定义 了 初始 化 操作 ， 并 且 指 
定 了 默认 mode 为 OLD 模式 ，OLD 模式 下 Sikuli 对 应 的 Java API 进程 会 在 init 初始 化 的 时 候 
跟随 一 起 启动 ,start_sikuli process 函数 中 定义 Sikuli Java API 进程 的 启动 过 程 ， 从 源码 中 可 以 
看 到 , 启动 时 是 通过 执行 java -jar SikuliLibrary jar 命令 的 方式 来 启动 SikuliLibrary 的 Java API 
进程 ， 通 过 connect remote library 函数 来 连接 启动 好 的 Java Remote 服务 ， 然 后 通过 
run keyword 函数 来 执行 Ride 上传 入 的 关键 字 操 作 。 


sikuli.py 的 部 分 源码 如 下 : 


def init (self, port=0, timeout-3.0, mode-'OLD'): 


(port: sikuli java process socket port 
Gtimeout: Timeout of waiting java process started 
@mode: if set as 'DOC', will stop java process automatically, 
if set as 'PYTHON', means library is running out of robot environment 
if set as 'CREATE', it is only for mvn package usage, will create 
keywords.py file 
if set as 'OLD'(default), sikuli java process will be started when 
library is inited 
if setas 'NEW', user should use 'start sikuli process' to start java 


self.logger - self. init logger() 
self.timeout - float(timeout) 
self.port - None 

self.remote = None 

self.mode = mode.upper().strip() 


if mode == 'OLD': 
self.start sikuli process (port) 
if mode.upper().strip() == 'DOC': 


self.start sikuli process() 
self. stop thread(4) 

elif mode.upper().strip() == 'PYTHON': 
self.connect sikuli process (port) 

elif mode.upper().strip() == 'CREATE': 
self. create keywords file() 

elif mode.upper().strip() != 'NEW': 
self. check robot running() 


def start sikuli process(self, port-None): 
"nn 
This keyword is used to start sikuli java process. 
If library is inited with mode "OLD", sikuli java process is started 
automatically. 
If library is inited with mode "NEW", this keyword should be used. 


:param port: port of sikuli java process, if value is None or 0, a random 
free port will be used 
return: None 


if port is None or int(port) == 0: 
port = self. get free tcp port() 

self.port — port 

start retries = 0 

started = False 

while start retries < 5: 
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try: 
self. start_sikuli_java_process() 
except RuntimeError as err: 
i *&s' $ err) 
if self.process: 
self.process.terminate process () 
self.port = self. get free tcp port () 
start retries += 1 


continue 
started = True 
break 


if not started: 
raise RuntimeError('Start sikuli java process failed!') 
self.remote = self. connect remote library() 
def connect remote library (self): 
remoteUrl = 'http://127.0.0.1:$s/' $ str(self.port) 
remote = Remote (remoteUrl) 
self. test get keyword names (remote) 
return remote 
def start sikuli java process (self): 
libFolder = os.path.join(os.path.abspath(os.path.dirname( file )), 
Lip”) 
jarList = glob.glob(libFolder + os.sep + '*.jar') 
if len(jarList) != 1: 
raise Exception ('Sikuli jar package should be exist in lib folder') 
SikuliJar = jarList[0] 
java = 'java' 
arguments = ['-jar', sikuliJar, str(self.port), 
self. get output folder()] 
self.process - Process() 
if os.getenv("DISABLE SIKULI LOG"): 
self.process.start process(java, *arguments, shell-True) 
else: 
self.process.start process(java, *arguments, shell-True, 
stdout-self. output file(), 
stderr-self. err file()) 
self.logger.info('Start sikuli java process on port $s' % str(self.port)) 
self. wait process started() 
self.logger.info('Sikuli java process is started') 


def run keyword(self, name, arguments-[], kwargs={}): 
if name == 'start sikuli process': 
return self.start sikuli process (*arguments) 
return self.remote.run keyword(name, arguments, kwargs) 


5.24 SikuliLibrary 常用 关键 字 介绍 
表 5-2-1 介绍 了 SikuliLibrary 库 中 常用 关键 字 的 用 法 。 
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表 5-2-1 SikuliLibrary 库 中 常用 关键 字 的 用 法 


关键 字 


使 用 描述 


Click 


该 关键 字 用 于 模拟 单 击 屏幕 中 指定 的 图 像 ， 接 收 [ image | xOffset=0 | 
yOffset-0 ] 三 个 参数 ，image 参数 指 的 是 图 片 的 实际 位 置 ，xOffset 和 yOffset 
为 指定 图 片 的 坐标 位 置 ， 如 果 不 传 入 的 话 ， 默 认为 (0.0) 


Click In 


Double Click 


该 关键 字 用 于 模拟 在 指定 的 目标 图 像 上 单 击 指定 区 域 的 图 像 ， 接 收 
[ arealmage | targetImage ] 两 个 参数 ，targetImage 参数 指 的 是 目标 图 片 ， 
arealmage 参数 指 的 是 目标 图 像 上 指定 的 图 像 区 域 ， 这 两 个 参数 都 是 传 入 图 
片 的 实际 路 径 

该 关键 字 和 Click 关键 字 类 似 ， 不 同 的 是 ， 这 个 关键 字模 拟 的 是 对 屏幕 上 指 
定 的 图 像 做 双击 操作 


Double Click In 


Drag And Drop 


Drag And Drop By 
Offset 


Exists 


Get Current Screen Id 
Capture Screen 


该 关键 字 和 Click In 关键 字 类 似 ， 不 同 的 是 ， 该 关键 字模 拟 的 是 对 目标 图 像 
上 指定 图 像 区 域 做 双击 操作 

该 关键 字模 拟 的 是 拖 动 操作 ， 接 收 [ srcImage | targetImage ] 两 个 参数 ， 模 拟 
从 源头 像 (srcImage) 拖 动 到 目标 图 像 (targetImage)， 参 数 srcImage 和 
targetImage 都 是 传 入 图 像 的 实际 路 径 

该 关键 字 和 Drag And Drop 关键 字 很 类 似 ， 不 同 的 是 ，Drag And Drop By 
Offset 是 通过 offset. 的 方式 将 源头 像 拖 动 到 指定 的 目标 区 域 ， 该 关键 字 接 收 
[srcImagelxOffsetlyOffset] 三 个 参数 ， 参 数 srcImage 指 的 是 源头 像 的 实际 路 
径 ， 参 数 xOffset 和 yOffset 指 的 是 拖 动 到 的 目标 区 域 的 坐标 位 置 

该 关键 字 用 于 断言 在 屏幕 上 是 否 存在 指定 的 图 像 ， 该 关键 字 接 收 [ image | 
timeout= ] 两 个 参数 ，image 指 的 是 图 像 的 实际 路 径 ，timeout 是 超时 时 间 ， 超 
过 指定 超时 时 间 后 ， 会 返回 失败 

该 关键 字 用 于 获取 当前 屏幕 的 id，SikuliLibrary 中 对 屏幕 进行 编号 

该 关键 字 用 于 抓 屏 


Get Match Score 该 关键 字 用 于 从 屏幕 上 获取 指定 图 像 的 匹配 度 ， 该 关键 字 接 收 [ image ] 一 个 
参数 ，image 指 的 是 图 片 的 实际 路 径 

Right Click 该 关键 字 用 于 模拟 鼠标 右 击 操作 ， 接 收 [ image ] 一 个 参数 ，image 指 的 是 图 
片 的 实际 路 径 

Right Click In 该 关键 字 用 户 模 拟 在 指定 目标 图 像 区 域 的 指定 图 像 区 域 上 做 鼠标 右 击 操 
作 ， 接 收 [ areaImage | targetImage ] 两 个 参数 ，targetImage 参数 指 的 目标 图 
片 ，areaImage 参数 指 的 是 目标 图 像 上 指定 的 图 像 区 域 ， 这 两 个 参数 都 是 传 
入 图 片 的 实际 路 径 

Screen Should Contain | 该 关键 字 用 于 判断 屏幕 上 是 否 存 在 指定 的 图 像 , 接收 [image] 一 个 参数 , image 


参数 需要 传 入 图 片 的 实际 路 径 


Set Capture Folder 


该 关键 字 用 于 设置 获取 到 的 图 片 的 路 径 ， 接 收 [ path ] 一 个 参数 
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Robot Framework 官网 提供 了 很 多 Lib。 除 了 官网 中 已 经 有 的 Lib 外 ， 我 们 还 可 以 自己 来 
编写 Lib， 既 可 以 使 用 Python 语言 来 编写 ， 也 可 以 使 用 Java 语言 或 者 其 他 的 编程 语言 来 编写 
自 定义 的 Robot Framework Lib. 


使 用 Python 编写 自 定义 的 


Robot Framework Lib 


6.1.1 使 用 Python 构建 Lib 工程 


可 以 用 来 开发 Python Lib 的 IDE 工具 很 多 ， 常 见 的 有 PyCharm, Eclipse with PyDev 插件 
等 。 在 Robot Framework 官网 中 已 经 提供 了 RobotFramework-EclipseIDE 插件 ， 访 问 地 址 为 
https://github.com/NitorCreations/RobotFramework-EclipseIDE, 可 以 直接 下 载 , 如 图 6-1-1 所 示 ， 
它 用 来 支持 Eclipse。 


NitorCreations / RobotFramework-EclipselDE OWsth 38 stwr 58 


Developing an Eclipse IDE for the Robot Framework test automation too! 


图 6-1-1 
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在 这 里 我 们 以 Eclipse with PyDev 插件 的 形式 来 构建 一 个 Lib ， 既 可 以 从 
http://www.pydev.org/ 下 载 对 应 的 插件 ， 也 可 以 通过 Eclipse 在 线 安装 的 方式 进行 安装 。 在 线 安 
装 的 地 址 为 http://www.pydev.org/updates， 如 图 6-1-2 所 示 。 


€ > C | © www.pydev.org/download.html 


* Eclipse 4.5, Java 8: PyDev 5.2.0 
* Eclipse 3.8, Java 7: PyDev 4.5.5 
* Eclipse 3.x, Java 6: PyDev 2.8.2 
。 Python 2.5 or older: PyDev 5.5.0 
URLs for PyDev as Eclipse plugin 
Urls to use when updating with the Eclipse update manager: 
Latest version: 


Baanttp://www_pydev.org/updates 
Nightly builds: 
* http://www.pydev.org/nightly 
Browse other versions (open in browser to select URL for Eclipse): 


* http://www.pydev.org/update_sites 


Get zip releases 
* SourceForge download 


图 6-1-2 


启动 Eclipse 后 ， 单 击 Eclipse 菜单 Help Install New Software...， 在 弹出 的 对 话 框 中 单 击 
Add 按钮 ， 接 着 在 Name 文本 框 中 输入 “Pydev”， 在 Location 文本 框 中 输入 
“http://pydev.org/updates”， 如 图 6-1-3 和 图 6-1-4 所 示 。 


Available Software 
Select a site or enter the location of a site. 


Work with? MEERE ~ [adan 
Find more software by working with the "Available Software Sites" preferences. 
[wee fiter text 


Name Ver: 
E (D There is no site selected. 


[itan ul 
Details 

Show only the latest versions of available software V Hide items that are already installed 

|Z] Group items by category What is already installed? 


[V Show only software applicable to target environment 
El Contact all update sites during install to find required software 


6-1-3 
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6-1-4 


单 击 OK 按钮 后 ， 可 以 看 到 供 安装 的 插件 选项 , 这 里 我 们 选择 全 部 安装 , 如 图 6-1-5 所 示 。 


Available Software 
Check the items that you wish to install. 4 


Work with: Pydev - httpi//pydev.ora/updates - [ada 
Find more software by working with the -Axallable Sofware Sites" preferences. 


[type filter text 


Name v 


DELI 
E Ap PyO=v for Eclipse s| 
E1183. PyOev for Eclipse Developer Resources 3 
4 E sas PyDev Mylyn Integration (optional) 
I. purin Muten Intent Cd 
= = ‘ 


a 


Detaile 
l| Show only the latest versions of available software [Vi Hide items that are already installed 
l| Group items by category What is already installed? 


I| Show only software applicable to target environment 
IM Contact all update cites during install to find required software 


e = T ner == Jiwasa 


图 6-1-5 
然后 单 击 Next 按钮 ， 等 待 安装 完成 即 可 ， 如 图 6-1-6 和 图 6-1-7 所 示 。 


Available Software 
Check the iteme that you wich to install. 
Work with: [Pydev - htte://pydev.org/updates -JC aaa} 
Find more sofware by working with the “Available Software Sites” preferences. 
Name ve 
| 4 E us pyosv 
< PyDev for Eclipse 5 
| [Z] Gt PyDev for Eclipse Developer Resources s| 


< [| us) PyDev Mylyn Integration (optional) 


2 iteme selected 


I7] Show only the latest versions of available software [7] Hide iteme that are already installed 
[7] Group items by category What ie already installed? 


[7] Show only software applicable to target environment 
[ 1 Contact all update sites during install to find required software 
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图 6-1-7 


安装 完成 后 ， 需 要 在 Eclipse 中 配置 Python 解释 器 。 在 Eclipse 菜单 栏 中 ， 单 击 Windows 
一 Preferences， 在 对 话 框 中 选择 pyDev—Interpreter—Python Interpreter, "i; New 按钮 。 选 择 
python.exe 的 路 径 ， 打 开 后 显示 出 一 个 包含 很 多 复 选 框 的 窗口 ， 单 击 OK 按钮 ， 如 图 6-1-8 所 
示 。 


pon | | Python Interpreters 


Miis Python interpreters (e.g. python.exe). Deuble-cick to rename. 


IronPython Interprate Name Location New. | 


Jython Interpreter 2 C\Program Files (x85)\pyth C:\Program Files (186) python. 


Dowa 

BÀ Libraries | Forced Buitins | Predefined | P Environment | & String Substtution Variables 

System PYTHONPATH. Reorder with Drag & Drop. 

4 Bh System ibs e 

@ CAProgram Fies (x86)\pythor\it\site-packages\decorator-4.0.6-py2.7.e9g —— 
闻 cprogram Fies (86)\pythor\b\ste-packages\beautitusoup4-4.40-py2.7.2ag | [New £aorzipt) 
Š C\Program Fies 086) pythorVibViite-packages!robctframework ssHibrary-2.L1-py2.7.ega. 
4 C\Program Fies (x86)\python\it\site-packages\paramiko-L.160-py2.7.eq9 tc -一 | 


© CAProgram Fies (x86)\pythor\fib\site-packages\ecdsa-0.13-p/27.299 

而 C\Program Fies (x86)\pythori\ib\site-packages\pyopenss|-0.15.1-py2.7.e99 

d) C:\Program Fies (x86)\pythor\fib\site-packages\six-1.10.0-py2.7.e9g 

d C\Program Fies (x86)\pythori\ib\site-packages\configparser-3.5.002-py2.7-egg 

d) CAProgram Fies (x86)\pythori\ib\site-packages\pymysql+0.6.7-py27.egg 

© C\Program Fies (x86)\pythor\fi\site-packages\selerium-2.52.0-py27.299 

d) C:\Program Fies (x86)\pythor\\site-packages\robothemework pabot-022-pj27.egg 


而 CNProgram Fies (x86)\python\fb\site-packages\robctremotererver~1.0.1-py2.7.egg a 
w——a Beto pies] 一 sp- 一 | 
oe Geox) 
A 6-1-8 


插件 配置 完成 后 ,我们 就 可 以 使 用 Eclipse 来 构建 一 个 Python 项 目 了 。 这 里 我 们 新 建 一 个 
ExcelLibrary 项 目 ， 在 Project name 文本 框 中 输入 “ExcelLibrary”， 然 后 单 击 Finish 按钮 完成 
项 目 创建 ， 如 图 6-1-9 所 示 。 
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PyDev Project 


Directory | FAproject ] [Browse 


Project type 
Choose the project type 
@ Python © ython © IronPython 


Grammar Version 


Additional syntax validation: «no additional grammars selected». 国 


® Add project directory to the PYTHONPATH | 

© Create ‘sre’ folder and add it to the PYTHONPATH 

© Create links to existing sources (select them on the next page) 

© Don't configure PYTHONPATH (to be done manually later on) 
Working sets 


图 6-1-9 


6.12 使 用 Python 编写 自 定义 的 Lib 


Lib 项 目 创 建 完成 后 ， 我 们 就 可 以 编写 自己 的 Lib 了 。 这 里 我 们 编写 一 个 从 Excel 文件 中 
读 取 数据 的 Lib 示例 。 


$ —f- coding: üt£-8' —*= 


ver 


FABLE excel PERA=HH) xlrd Library 


ver 


import xlrd 


ver 


9A robot Framework MAE logger 


ver 


from robot.api import logger 


JEX— python class 


class ExcelUtil(): 
def _ init__(self): 
return 


HHF — f excel Xft 
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def open_excel (self, excelfile): 
try: 
data = xlrd.open_workbook (excelfile) 
return data 
except Exception,e: 
logger.error (e) 


RM excel PRŽI, IDR RE MRR excel Xft Hl sheetname 
def get_excel_bysheetname (self, excelfile, lineindex=0, sheetname='Sheetl'): 
data = self.open excel(excelfile) 
sheet = data.sheet by name (sheetname) 
rows = sheet.nrows 
linedata = sheet.row_values (lineindex) 
list = D 
for rownum in range(1, rows): 
row = sheet.row_values (rownum) 
if row: 
app = {} 
for j in range (len (linedata)): 
app[linedata[j]] = row[j] 
list.append (app) 
return list 


在 示例 代码 中 , 定义 了 函数 get excel bysheetname 来 获取 Excel 文件 中 的 数据 ,可 以 通过 
参数 来 指定 需要 获取 Excel 文件 哪个 sheet 中 的 数据 , 获取 到 的 sheet 数据 最 终 以 List 的 形式 返 
回 。List 中 的 每 一 条 记录 都 是 以 Python 中 的 字典 形式 存储 进去 的 。 

我 们 可 以 调用 一 下 我 们 写 的 lib， 看 看 是 否 可 以 正常 使 用 。 在 RIDE 中 ， 我 们 导入 刚刚 写 
的 Lib， 如 图 6-1-10 所 示 。 


| Edit | Text Edit | Run 


TestSuite7 
Source F:\project\RobotFrameworkTest!\RobotFrameworkTest1 VTestSuite7 xt 


Import Name / Path Arguments 
Library CyProgram Files (x86)/python/Lib/zite-packages/Excelti.. 


图 6-1-10 


然后 在 RIDE 中 按 F5 快捷 键 ， 可 以 看 到 我 们 自 定义 的 关键 字 ， 如 图 6-1-11 所 示 。 
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Search term: | Q, 


Source: [Exceiuti >J 
Name Source Description 
Open Excel ExcelUtil | 
I 
| 
Name: Get Excel Bysheetname 
Source: — ExcelUti «test library» 


Arguments: [ exceffile | lineindex=0 | sheetname-Sheet1 ] | 


Find Usages 


6-1-11 


导入 后 ， 我 们 可 以 通过 一 个 测试 用 例 调用 一 下 ， 并 且 将 结果 以 log 形式 输出 。 


${list} Get Excel Bysheetname E:\\task.xls 
log ${list} 


运行 结果 如 图 6-1-12 所 示 。 


l critical test. 1 passed. 0 failed 
1 test total. 1 passed. 0 failed 


RobotFranevorkTest1 
1 critical test. 1 passed, L 
1 test total. 1 passed. 0 failed 


log c: users \yonsgine \appdaca\local\temp\EIDEugeapé dvlog tl 
Report: c 'VuserssyongqingsappdastaNlocalstewpxPTDFuqeup6 d\report html 


test finished 20170715 13.21 35 
“Ü X: 


Starting tect: RobotEranevorkTes: 1 TestSzite? TesiCaseDUL 
Hist s [o u7 2606001 = y!yugSbOvaSeea!  y/suSREdva71Evubdet asses! 4D. a \uBt7S\u76ee a 
Uo ?a onl: "u'SugbbOvuSofa" w SuSE us? lf vaGdos ue M6: 4.0, ui \u9876\u7ée0' ul Sub7IeNub 
Ending test. RobotfranevorkTest i Testoni te? TesiComebb 


E 6-1-12 
从 结果 我 们 可 以 看 到 ， 以 Unicode 格式 的 形式 输入 了 一 个 List，List 中 的 每 一 个 元 素 都 是 
一 个 字典 。 
6.1.3 打包 自 定义 的 Lib 


Python 打包 自 定 义 的 Lib 需要 遵循 Python 语言 的 模块 导入 规范 ， 我 们 需要 首先 建立 一 个 
init .py 文件 ， 如 图 6-1-13 所 示 。 
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X^ 


Ye 收 训 夫 修改 日 其 E] 
d TE Bey 2017/7/15 12:53 x 
3 最 拆 访问 [la _init_py 2017/7/15 13:14 Python File 1KB 
an Ë _init_pyc 2017/7/15 12:57 Compiled Pytho. KB 
6-1-13 


RAE init py 中 定义 需要 对 外 提供 的 Library, TE import 中 需要 导入 已 经 编写 好 的 自 
定义 的 Library 模块 ， 并 且 导 入 已 经 定义 好 的 Library 的 版 本 文件 ， 如 图 6-1-14 和 图 6-1-15 所 


不 。 


from py excel ExcelUtil import ExcelUtil 
from py excel version import VERSION 


class Excellibrary ExcelUtil) 
ROBOT, LIBRARI, VERSION = VERSION 


图 6-1-14 


iB version.py 


图 6-1-15 
定义 好 的 Library 的 package 层次 如 图 6-1-16 所 示 。 


Y Bu Excellibrary 


上 面 这 些 全 部 完工 后 ， 我 们 就 可 以 把 做 好 的 Library 放 到 Python 的 Lib\site-packages 目录 
下 了 。 这 样 在 RIDE 中 就 可 以 直接 导入 我 们 定义 的 名 称 为 ExcelLibrary 的 Library 了 ,如 图 6-1-17 


Bras; 并 且 通 过 F5 快捷 键 也 可 以 看 到 Library 下 的 关键 字 ， 如 图 6-1-18 所 示 。 
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Edit| Text Edit | Run | 
Source F:\project\RobotFrameworkTest! \RobotFrameworkTest1\TestSuite7.tct 
Settings >> 
Import Name / Path Arguments Comment 
[Library Excellibrary 
6-1-17 
W3 Search Keywords 
Search term: Q, Search [|Search documentation 
Source: [Exceltbrary = 
Name Source Description 
Get Excel Bysheetname ExcelLibrary 
Open Excel ExcelLibrary 
Name: Get Excel Bysheetname 
Source: — Excelibrary «test library> 
Arguments: [ exceffile | lineindex=0 | sheetname=Sheet1 ] 


图 6-1-18 


6.1.4. Remote 远程 库 


在 自动 化 测试 时 ， 有 时 并 不 是 所 有 的 Library 库 都 安装 部 署 在 本 地 运行 环境 上 ， 或 者 说 为 
了 解决 本 地 自动 化 测试 环境 安装 多 个 Library 库 所 带 来 的 复杂 工作 量 ，Robot Framework 设计 
了 通过 Remote 的 方式 来 进行 远程 调用 。 通 过 远程 调用 的 方式 ， 可 以 调用 服务 器 上 的 远程 库 ， 
调用 时 采用 XML-RPC 远程 调用 协议 。 该 方式 还 可 以 解决 跨 语言 调用 的 问题 。 因 为 采用 了 远程 
调用 的 方式 ， 所 以 服务 端的 远程 库 可 以 是 多 种 不 同 的 语言 ， 只 需要 提供 远程 调用 服务 即 可 。 图 
6-1-19 中 的 流程 描述 了 一 个 测试 用 例 在 执行 时 如 何 通过 XML-RPC 的 形式 来 调用 远程 库 的 过 
程 。XML-RPC 协议 本 质 是 一 个 HTTP 协议 通信 下 的 远程 调用 方式 。 


本 地 测试 案例 ? Remote Library 
x * 
à XML-RPC a 
Robot Framework 运 行 框架 Server Library 
z 
Remote Library | 库 方法 运行 
6-1-19 
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Robot Framework 提供 了 远程 调用 接口 库 ， 可 以 通过 GitHub 
https://github.com/robotframework/RemoteInterface ) 来 获取 远程 Remote 接口 
Framework 中 提供 了 8 种 不 同 语言 


(地 址 为 
库 。 Robot 


RAE, 3648 Y Python, Java, Ruby, .net, Clojure, Perl, 


Node.js 和 PHP. Robot Framework 正 是 通过 远程 调用 接口 库 来 实现 跨 语 言 支持 的 。 这 些 不 同 
的 语言 版 本 ， 都 可 以 在 GitHub 中 下 载 到。 我 们 在 后 面 讲 到 的 使 用 Java 来 编写 自 定 义 的 Lib 库 


也 是 会 基于 远程 调用 接口 协议 来 进行 实现 的 。 


这 里 我 们 以 Python 库 为 例 ， 讲 述 Remote 库 的 使 用 过 程 。 远 程 服务 配置 如 表 6-1-1 所 示 。 


表 6-1-1 远程 服务 配置 信息 


服务 端的 启动 时 的 服务 监听 地 址 ， 一 般 建议 使 用 “0.0.0.0” 
端 这样 可 以 保证 外 部 的 客户 端 都 可 以 调用 和 访问 


'127.0.0.1' 


host 


占用 ， 可 以 根据 实际 情况 进行 调整 和 修改 
将 启动 占用 的 port 输出 到 一 个 文件 中 


allow_remote_stop | True 


可 以 通过 关键 字 Stop Remote Server 来 停止 远程 接口 服务 


服务 端 监 听 服 务 启 动 时 指定 的 启动 端口 号 ， 默 认为 8270。 端 口号 如 果 被 


这 是 一 个 启动 参数 , 默认 值 为 True, 表示 允许 在 调用 远程 Server 接口 时 ， 


来 启动 服务 


首先 需要 自己 定义 一 个 远程 Python 接口 服务 端 ， 然 后 将 其 启动 起 来 。 想 要 自己 定义 一 个 


远程 调用 


服务 端 ， 需 要 通过 from robotremoteserver import RobotRemoteServer 引入 


RobotRemoteServer 服务 端 。 然 后 调用 RobotRemoteServer 服务 的 初始 化 方法 。 在 如 下 的 Python 
脚本 示例 中 ， 我 们 自己 定义 了 启动 远程 调用 监听 服务 的 地 址 和 端口 。 


RemoteExample.py 

#coding:utf8 

from robotide.lib.robot.libraries.String import String 

from robotremoteserver import RobotRemoteServer 

class RemoteExample: 
def _ int_ (self): 

pass 

if name == ' main ': 
RobotRemoteServer(String(), host-'0.0.0.0', 


port-8270,port file-'d://remote-port.txt') 


然后 运行 RemoteExample.py 脚本 ， 会 在 本 地 启动 我 们 需要 的 远程 接口 服务 ， 如 图 6-1-20 


所 示 。 
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“C:\Program Files (x85) python python exe” F /project/robot-framworl/con/robot/remote/exanple/RemoteExample. py 
Robot Framework remote server at 0.0.0.0:8270 starting 


Run tM RemoteExample 


G 
= 
"s 
gs | (Es) 
x | 
x< 
? 


6-1-20 


我 们 再 来 简单 分 析 一 下 robotremoteserverpy 脚本 。 在 脚本 的 初始 化 方法 中 ， 我 们 也 可 以 
看 到 需要 传 入 的 参数 ， 包 括 library. host. port. port file, allow stop. library 就 是 远程 接口 服 
务 启动 时 需要 将 服务 端的 本 地 库 加 载 为 远程 调用 接口 服务 的 library。 在 上 面 我 们 启动 的 自 定义 
服务 中 ，library 加 载 的 是 robotide.lib.robot.libraries.String 中 的 String 库 。host 和 port 如 果 不 传 
入 的 话 ， 默 认为 127.0.0.1 和 8270， 和 我 们 上 面 提供 的 表格 中 的 远程 服务 配置 参数 是 一 致 的 ， 
如 图 6-1-21 所 示 。 


aec BPW: Library, host=’ 127 0 0.1°, port=9270, port_£ile=Mone, 
allow stop-Irue) 


figure and start-up remote server 


SimpleXMLRPCServer init  (s&1f, (host, int(port)), loeRequests=False) 
self library = library 

self allow stop = allow stop 

self shutdown = False 

functi ons O 

signal handlers O 


start (port file) 


self serve forever () 
B 6-1-21 


自 定 义 的 远程 调用 接口 服务 启动 后 ,我 们 在 RIDE 客户 端 中 可 以 通过 import 的 方式 导入 远 
程 调用 接口 库 ， 如 图 6-1-22 所 示 。 


Import Name / Path Arguments Comment 
Library Remote 127.0.0.1:8270 


图 6-1-22 


此 时 我 们 通过 FS 快捷 键 查看 一 下 Remote 库 下 的 关键 字 方 法 ， 如 图 6-1-23 所 示 。 
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Name Source Description < 
Convert To Lowercase Remote Converts string to lowercase. 7 
Convert To Uppercase Remote Converts string to uppercase. 

Decode Bytes To String Remote Decodes the given "bytes" to a Unicode string using... 
Encode String To Bytes Remote Encodes the given Unicode "string" to bytes using t... 
Fetch From Left Remote Returns contents of the "string" before the first occu... 
Fetch From Right Remote Returns contents of the "string ` after the last occurr... 
Generate Random String Remote Generates a string with a desired "length" fromthe.. | 
EAT PEERS Kas PARERE pe sss, 

Name: Convert To Lowercase ES 

Source: Remote «test library> 

Arguments: [ string ] z 

Converts string to lowercase. 

Examples: 

[seen j= | ouvert Tp [eec | 

La [Convert Tn [ T 

Find Usages 

图 6-1-23 


可 以 看 到 Remote 下 包括 String Library 库 下 的 所 有 关键 字 ， 服 务 端 本 地 的 String Library 
库 就 变 成 了 一 个 远程 接口 服务 以 供 我 们 调用 。 


【示例 】 调 用 Remote 下 的 Convert To Lowercase 关键 字 。 


${str} Set Variable asasAAdddsfDDDD 


Convert To Lowercase ${str} 


${result} 
log ${result} 


运行 结果 如 图 6-1-24 所 示 。 


- E339 TestCase0001 
Full Name: RobotFrameworkTest1. TestSuite8. TestCase0001 
Start / End / Elapsed: 20180812 15:09:58.520 / 20180812 15:09:58.530 / 00:00:00.010 
Status: (critical) 


= S(str) = Buitin . Set Variable asasAAdddsfDDDD 


Documentation: Returns the given values which can then be assigned to a variables. 
Start / End / Elapsed: 20180812 15:09:58.530 / 20180812 15:09:58.530 / 00:00:00.000 
15:09:58. 530 INFO ${str} = asasAAdddsfDDDD 


= S{result} = Remote. Convert To Lowercase ${str} 


Documentation: Converts string to lowercase. 
Start / End / Elapsed: 20180812 15:09:58.530 / 20180812 15:09:58.530 / 00:00:00.000 
15:09:58. 530 INFO  $íresult] = asasaadddsfdddd 


- CEL sum og sess 


Documentation: Logs the given message with the given level. 
Start / End / Elapsed: 20180812 15:09:58.530 / 20180812 15:09:58.530 / 00:00:00.000 
15:09:58. 530 INFO asasaadddsfdddd 

6-1-24 
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用 时 


也 可 
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在 实际 使 用 时 ， 建 议 你 通过 netsh 工具 抓 包 的 方式 去 查看 Remote 远程 调用 接口 服务 在 调 


是 如 何 进行 通信 的 。 
在 自 定 义 远程 接口 服务 中 ， 除 了 可 以 使 用 robotide.lib.robot.libraries 中 已 有 
以 使 用 我 们 自己 编写 的 Library。 下 面 我 们 自 定义 一 个 Library: 


的 Library 外 ， 


ExampleLibrary.py 


#coding:utf8 


class ExampleLibrary (object): 
def int (self): 


pass 


def add(self,x,y): 


print 'serivce is called' 
return int (x)+int(y) 


pass 


定义 好 后 ， 在 RobotRemoteServer 中 使 用 ExampleLibrary 来 进行 启动 ， 如 图 6-1-25 所 示 。 


#coding:utf8 


from robotide.lib.robot.libraries.String import String 


from robotremoteserver import RobotRemoteServer 


from ExampleLibrary import ExampleLibrary 


class RemoteExample: 
def int (self): 


pass 


if name == ' main ': 


RobotRemoteServer (ExampleLibrary(), host-'0.0.0.0', 
port=8270,port file-'d://remote-port.txt') 


"C:\Program Files (x88) python python. exe” F:/project/robot-framwork/con/robot/renote/exanple/RenoteExanple. py 
Robot Framework remote server at 0 0.0,0:8270 starting 

= 

图 

tm 


图 6-1-25 


启动 成 功 后 ， 我 们 可 以 通过 Fs 快捷 键 来 查看 自 定义 的 ExampleLibrary E H 


图 6-1-26 所 示 。 


PREF, w 
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/&* Search Keywords 
|| Search term: Q search V| Search documentation 


Source: [ Remote - 


Name Source Description 
Add Remote 


Stop Remote Server Remote 


Name: Add 


I Source: Remote «test library» 
Arguments: [x|y] 


6-1-26 
调用 一 下 我 们 自 定义 的 ExampleLibrary 库 中 的 Add 关键 字 。 


${result} Add 3 4 
log ${result} 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite8.TestCase0002 
20180812 17:07:33.531 : INFO : serivce is called 

20180812 17:07:33.532 : INFO : ${result} = 7 

20180812 17:07:33.533 : INFO : 7 

Ending test: RobotFrameworkTestl.TestSuite8.TestCase0002 


6.2 使 用 Java 编写 自 定义 的 


Robot Framework Lib 


6.2.1 在 Robot Framwork 中 调用 Java Lib 库 


我 们 在 前 面 介绍 了 Robot Framework 可 以 支持 跨 语言 ， 对 Java 也 是 可 以 支持 的 。 在 Robot 
Framework 中 ，RIDE 本 身 提 供 了 对 测试 用 例 的 两 种 执行 方式 ， 支 持 pybot 和 jybot 两 种 执行 方 
式 ， 如 图 6-2-1 所 示 。 
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Edit | Text Edt | Run 
Execution Profile: [bot od Report - Log D] Autosave [Í | Pause on faiure [V] Show message log 


» Start *) CERTE e DContnue @) Next » 
Arguments: 


El On run tests with these tags E Skip tests with these tags 


6-2-1 


jybot 就 是 以 Java 虚拟 机 的 形式 来 执行 测试 用 例 ， 在 执行 的 环境 中 需要 安装 Java IDK 运 
行 环境 以 及 Jython 安装 包 。 Jython 是 一 个 Python 语言 在 Java 中 的 完全 实现 , 也 就 是 说 用 Java 
来 实现 了 Python 语言 的 功能 。Jython 中 既 提 供 了 Python 库 ， 也 支持 Java 方法 的 执行 解决 了 
Robot Framework 中 Python 不 支持 直接 调用 Java 语言 的 问题 。Jython 可 以 从 
http://www.jython.org/downloads.html 页 面 中 进行 下 载 , 安装 完成 后 就 可 以 在 Robot Framework 
中 使 用 了 ， 如 图 6-2-2 所 示 。 


C | © wwwjythonorg/u ads htm 


Jython: Python for the Java Platform 


Downloads 
Te 


stable release of hon i 2 


70. Fa pra 


low to dowload Uw Java installar. ce dowrcadad, have dauid on tha JAR e to start e instalation proces. You ray also wart to read fw talon 
pon row or the rene Notes 


Jython 2.7.0 


Jython 2.5.4rc1 


1 bulo sikek jar rinse then 


ston Book 


25401 Standalone Jar: For enibeóng Moon i Zn applicato 


Previous Releases 


Front page/ News 
D 
Way thon? 


User Guido 


MOS: LIESESSES ACT 
prd 


Books and Arties yon 25.2 


yb Monty + Mos: Tagastftabatoactliatod 


图 6-2-2 


下 面 我 们 来 看 一 个 Jython 语言 执行 测试 用 例 的 例子 。 
【示例 】 用 Jython 语言 将 字符 串 全 部 转换 成 大 写 形式 。 


${str} Set Variable aaBBccDDeeFF 
${result} Convert To Uppercase ${str} 
log ${result} 


结果 如 图 6-2-3 所 示 。 这 里 我 们 选择 使 用 jybot 来 执行 ， 同 pybot 一 样 得 到 了 我 们 想 
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框架 核心 指 


Edt Text Edt : Run: 


4d bx 


Report = Log V| Autosave (7| Pause on faiure 


Continue ` (9) Next 


© Step over 


E Skp tests with these tags 


1 critical test 
1 test total. 


1 critical test. 
1 test total. 1 


+ ——x=— 


RobotFrameworkTestl TestSuite8 
ssed 


1 pa: 0 failed 


1 passed, 0 failed 


RobotFranevorkTest1 


1 0 failed 
. 0 failed 


D 


Starting test 


Ending test 


图 6-2-4 所 示 。 


RobotFrameworkTesti TestSuite8 TestCase0003 


20180812 17:47:32.155 : INFO : ${str} = aaBBccDDeeFF 
20180812 17:47:32.212 : INFO ` S{result} = AABBCCDDEEFF 
20180812 17:47:32.225 : INFO 


RobotFrameworkTesti TestSuite8.TestCase0003 


图 6-2-3 
其 实在 Robot Framework 的 官方 网 站 中 很 多 Library 库 都 提供 了 Java 语言 版 本 的 实现 ， 如 


STANDARD 


Android Library 


Library for all your Android automation needs. It nses 
Calabash Android internally. 


Archive library 
Library for handling zip- and tar archives. 


Database Library (Java) 


‘Java-based library for database testing. Usable with 
Jython. Available also at Maven central. 


Django Library 
Library for Django, a Python web framework. 


FTP Library 


Library for testing and using FTP server with Robot 
Framework. 


MttpRequestLibrary (Java) 


Library for HTTP level testing using Apache HTTP 
client. Available also at Maven central. 


JavaFXLibrary 


Library for testing JavaFX applications, based on 
TestFX. Has also remote interface support. 


Noclientiibrary 
Juttps://gitluib.com/ucclient/ncelient 


Anywherenibrary 


Library for testing Single-Page Apps (SPA). Uses 
Selenium Webdriver and Appium internally. 


ButcltLibrary 


Windows GUI testing library that uses Autolt freeware 
asa driver. 


Database Library (Python) 
Python based library for database testing. Works with 
any Python interpreter, including Jython. 

Eclipse Library 

Library for testing Eclipse RCP applications using SWT 
widgets. 


HTTP Library (livetest) 


Library for HTTP level testing using livetest tool 
internally 


ios library 


Library for all your iOS automation needs, It uses 
Calabash iOS Server internally. 


MongoDB library 
Library for interacting with MongoDB using pymongo. 


Generic network protocol test library that offers easy 
‘way to specify network packets and inspect the results 
of sent and received packets, 


图 6-2-4 


Appiumrbrary 


Library for Android- and iOS-testing. It uses Appium. 
internally 


CncLibrary 
Library for driving a CNC milling machine. 


Diff Library 
Library to diff two files together. 


robot franework-faker 
Library for Faker, fake test data generator, 


HTTP library (Requests) 
Library for HTTP level testing using Request internally. 


InagelorizonLibrary 


Cross-platform, pure Python library for GUI automation 
based on image recognition. 


MOTT library 
Library for testing MQTT brokers and applications. 


BenoteswingLibrary 


Library for testing and connecting to a java process and. 
using SwingLibrary, especially Java Web Start 
applications, 


这 里 以 我 们 在 第 2 章 中 讲 到 的 Database Library Python 库 作为 示例 ， 看 一 下 这 个 库 对 应 的 
Java 语言 的 实现 以 及 如 何 通过 Java 语言 的 形式 来 进行 调用 。 

在 使 用 时 , 可 以 通过 Robot Framework 提供 的 maven 插件 robotframework-maven-plugin 来 
直接 引入 : 
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<dependency> 


«groupId»com.github.hi-fi«/groupId» 


<artifactId>robotframework-dblibrary</artifactId> 


<version>3.1.1</version> 
</dependency> 


或 者 将 源码 下 载 下 来 , 通过 执行 编译 打包 的 方式 生成 。 这 


行 编译 ， 源 码 可 以 从 https: 


里 我 们 选择 直接 用 源码 的 形式 进 


github.com/Hi-Fi/robotframework-dblibrary 上 直接 获取 到 。 下 载 完 


成 ， 解 压 到 自己 需要 的 目录 后 ， 可 以 通过 emd 命令 行 切 入 对 应 的 目录 下 ， 使 用 maven 命令 行 


进行 编译 ， 前 提 是 需 


和 图 6-2-6 所 示 。 


EEA: C:\Windows\system32\cmd.exe 


ongaing>f = 


project \wemote java 


»botframework-dblibrary-m 


plug 
lipounioaded: http 
ing-naven-plugin 


\apache-maven-3 .3.3% 


BUILD 


renotejav. 
work-dblibrary-p 


打包 完成 后 ， 生 成 的 target 目录 中 


6-2-7 所 示 。 


要 在 自己 的 环境 中 事先 
clean install -Dmaven.test.skip=true 即 可 生成 我 们 想 要 的 Java 语言 


robot f ramework—db libre 


obotrenotes 


安装 好 maven 的 


oteserver-master 


编译 环境 。 编 译 打包 时 执行 mvn 
CALA Library 库 , 如 图 6-2-5 


co 


wobotframework-dblibrary 


install —Dmave 


° build 


plugin-1.6 


epo\com\git hub 


pnat ype/plugin 
3 - poi 

sonat ype/plugin 

3.pom <12 KB at 6.9 KB 


Jon] VARA En PEAY Java 语言 实现 的 Library, And 
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| È « robotframework-dblibrary-master » robotframework-dblibrary-master » target » v | $ || SE target P 
xA me SEV IAM BAH) 
aay [BI aR Guxam =- [3e 
Saat ^ sk ü SERE xm 
BTE J antrun 2018/8/12 18:11 — X 
d 最 5 访问 的 位 置 J dasses 2018/8/12 1810 — 文件 夫 
man Ji maven-archiver 2018/8/121810 — 文 伯 夫 
Je maven-status 2018/8/12 18:10 SHE 
as (is. robotframework-dblibr PSHOT; 2018/8/12 18:10 
(Bl Subversion |El 
| sz 
Bus 
En 
B xs 
G) BETE 
9 8s d 


6-2-7 


将 编译 生成 好 的 robotframework-dblibrary-3.2-SNAPSHOT jar 包 和 MySQL 的 Driver 驱动 
包 一 起 加 入 运行 环境 的 CLASSPATH 下 面 ， 然 后 在 测试 用 例 集中 引入 DatabaseLibrary 库 ， 如 
图 6-2-8 所 示 。 


Name / Path Arguments 
Databaselibrary 


图 62-8 


引入 后 ,我 们 就 可 以 正常 使 用 jython 的 方式 来 调用 Java 语言 版 本 的 DatabaseLibrary PE T , 
如 图 6-2-9 所 示 。 


Connect To Database ‘com.mysql. jdbc. Driver Jdbc:mysql: /fiocalhost: 3306/worid root root 
[SS 
图 6-2-9 


使 用 Java 语言 版 本 的 DatabaseLibrary 库 中 的 关键 字 时 ， 和 使 用 Python 语言 版 本 的 
DatabaseLibrary 库 中 部 分 关键 字 的 传 参 有 些 不 一 样 。Java 语言 版 本 的 DatabaseLibrary 连接 数 
据 库 时 是 通过 jdbe 的 方式 来 进行 的 。 这 里 我 们 列举 一 些 Java 语言 版 本 的 DatabaseLibrary EXE 
接 常 用 的 示例 ， 如 表 6-2-1 所 示 。Java 语言 版 本 的 Connect To Database 关键 字 接收 [数据 库 
driver 类 ljdbc 连接 地 址 | 数据 库 用 户 名 | 数据 库 密码 | alias=default ] 五 个 参数 。alias 如 果 不 传 入 的 
话 ， 默 认 取 名 为 default。 
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表 6-2-1 DatabaseLibrary 库 链 接 一 些 常用 数据 库 的 示例 


Connect To | com.mysql.jdbc. | jdbc:mysql://localhost:3306/world | root root | 连接 MySQL 数 
Database Driver 据 库 

Connect To | oraclejdbc.drive | jdbc:oracle:thin:@servername:port: | system | 12345678 | 连接 Oracle 数 
Database r.OracleDriver dbname 据 库 

Connect To | org.h2.Driver jdbc:h2:mem:robotframeworkt:DB | sa sa | 连接 n2 数据 库 
Database CLOSE DELAY=1 库 


这 里 我 们 看 一 个 Java 语言 实现 的 DatabaseLibrary 库 源 码 的 片段 ， 大 家 可 以 了 解 一 下 Java 
语言 版 本 中 是 如 何 实现 和 封装 关键 字 的 。 这 是 Connect To Database 关键 字 的 实现 方法 ， 我 们 
可 以 看 到 是 通过 在 方法 上 加 Java 注解 的 方式 来 实现 的 。@RobotKeyword 和 @ArgumentNames 
注解 均 来 自 javalib-core 库 ， 我 们 自己 在 开发 时 可 以 通过 maven 依赖 的 方式 引入 。 


<dependency> 
<groupId>org. robot framework</groupId> 
<artifactId>javalib-core</artifactId> 
<version>1.2.1</version> 
</dependency> 


DatabaseLibrary 库 的 源码 片段 : 


@RobotKeyword ("Establish the connection to the database. This is mandatory before 
any of" 
+ "the other keywords can be used and should be ideally done during the " 
+ "suite setup phase. To avoid problems ensure to close the connection again 


+ "using the disconnect-keyword.\n\n" 
+ "It must be ensured that the JAR-file containing the given driver can be 


+ "found from the CLASSPATH when starting robot. Furthermore it must be " 

+ "noted that the connection string is database-specific and must be valid 
of course.\n\n" 

+ "If alias is given, connection can be later referred with that. If alias 
was in use, existing connection " 

+ "is replaced with new one\n\n" + "" + "Example: \n" 

+ "| Connect To Database | com.mysql.jdbc.Driver | 
jdbc:mysql://my.host.name/myinstance | UserName | ThePassword | default |") 
@ArgumentNames({ "Driver class name", "Connection string", "Database username", 
"Database password","Database alias-default" }) 
public void connectToDatabase (String driverClassName, String connectString, 
String dbUser, String dbPassword, 

String... aliasParam) 

throws SQLException, InstantiationException, IllegalAccessException, 
ClassNotFoundException { 

String alias = aliasParam.length > 0 ? aliasParam[0] : defaultAlias; 

Class.forName(driverClassName).newInstance(); 

setConnection (DriverManager.getConnection(connectString, dbUser, 
dbPassword), alias); 


l 
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除了 通过 Jython 语言 来 调 
H Java 语言 实现 的 Library 库 。 从 https://github.com/ombre42/jrobotr: 
取 到 用 Java 来 实现 的 远程 接口 服务 ， 如 图 6-2-10 所 示 。 


语言 


H Java 的 Library 外 ， 我 们 还 可 以 通过 Remote 的 方式 来 实现 调 


emoteserver 链接 中 可 以 获 


€ > Q a # | httpsy//qithub.com/ombre42/jrobotremotesenvel 


© Code 


amples/AnnorationLibrary 


图 6-2-10 


我 们 不 建议 在 实际 工作 中 过 多 地 使 用 
每 个 测试 用 例 在 执行 时 都 需要 一 个 启动 jvm 虚拟 机 的 过 程 ， 会 比 使 


耗 时 更 长 , 而 且 兼 容 性 并 不 是 十 分 好 , 推荐 使 用 Remote 的 方式 来 调用 Java 


库 。 


6.22 使 用 Java 编写 自 定 义 的 Lib 


前 
语言 编写 自 定义 的 Lib 库 。 


要 使 用 Java 编写 自 定义 Lib 库 ， 我 们 首先 需要 构建 一 个 Java KH 


Qua 1 


面 我们 已 经 讲 了 如 何 调用 Java 语言 编写 的 Lib 库 ， 这 里 我 们 将 介绍 


Latest commit 6882533 cn Nov 19 2015 


Jython 的 方式 来 调用 Java 语言 实现 的 Library, 因为 


Python 语言 的 方式 执行 


言 实现 的 Library 


五 


IH 


下 如 何 使 


Java 


发 工程 。 这 里 以 构建 一 


个 Java 的 maven 项 目 为 例 。 在 构建 的 maven 工程 的 pom xml 文件 中 ， 我 们 需要 引入 如 下 必要 
依赖 。 
<dependency> 


<groupId>org. robot framework</groupId> 
<artifactId>javalib-core</artifactId> 
<version>0.9.1</version> 


</dependency> 


这 个 是 必须 引入 的 依赖 包 ， 作 用 是 提供 了 创建 RobotFramework 关键 字 的 注解 等 功能 ， 方 
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便 我 们 快速 创建 一 个 Lib 库 以 及 对 应 的 关键 字 。 


<dependency> 
<groupId>com.github.ombre42</groupId> 
<artifactId>jrobotremoteserver</artifactId> 


<version>2 .0-BETA</version> 
</dependency> 


这 是 Remote Server 的 依赖 包 ， 作 用 是 可 以 启动 一 个 RobotFramework 的 远程 调用 接口 服 
务 ， 然 后 在 RIDE 中 通过 Remote 的 方式 就 可 以 连接 到 该 远程 调用 服务 上 ， 如 果 不 使 用 远程 调 
用 服务 ， 就 可 以 不 引入 该 依赖 包 。 


<plugin> 
<groupId>com.googlecode. robot framework-maven-—plugin</groupId> 
<artifactId>robot framework-maven-plugin</artifactId> 
<version>1.1.1</version> 
<executions> 
<execution> 
<phase>test</phase> 
<goals> 
<goal>run</goal> 
</goals> 
</execution> 
</executions> 
<configuration> 
<variables> 
<variable>BUILDING:True</variable> 
</variables> 
</configuration> 
</plugin> 
</plugins> 


这 是 Robot Framework 提供 的 maven 插件 ， 不 是 一 个 必需 的 maven 工程 依赖 。 该 插件 的 
作用 在 于 可 以 模拟 RIDE 来 执行 测试 用 例 ， 在 使 用 maven 编译 打包 时 可 以 同时 执行 Robot 
Framework 的 测试 用 例 。 通 过 如 下 方式 来 指定 测试 用 例 的 位 置 。 


<testResources> 
<testResource> 
<directory>src/test/resources</directory> 
<filtering>true</filtering> 
</testResource> 
</testResources> 


在 maven 工程 构建 好 了 后 ， 就 可 以 编写 自 定义 的 Lib ÆT o K 6-2-2 中 描述 了 使 用 Java 
语言 来 编写 自 定 义 Lib 时 一 些 常 用 的 Java 注解 。 
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表 6-2-2 常用 的 Java 注解 


注解 名 称 使 用 描述 
@RobotKeywords 该 注解 一 般 用 于 Java 类 的 头 部 ， 用 来 标注 该 Java 类 提供 的 是 一 个 Robot Framework 
关键 字 类 


@RobotKeyword 该 注解 和 @RobotKeywords 注解 需要 一 起 配合 使 用 。@RobotKeyword 注解 一 般 用 于 
Java 中 某 个 具体 方法 的 头 部 ， 用 来 标注 该 方法 提供 的 是 一 个 Robot Framework 关键 
字 。 可 以 通过 @RobotKeyword 后 面 加 括号 的 方式 来 说 明 该 关键 字 的 用 途 ， 比 如 
@RobotKeyword(" 这 是 一 个 示例 关键 字 ") 

@ArgumentNames 该 注解 需要 和 (@RobotKeyword 注解 一 起 使 用 ， 用 于 标注 一 个 Robot Framework 关键 
字 需 要 传 入 的 参数 。 示 例 : 


entNames({"elementString"}) 


【示例 1 】 使 用 Java 的 方式 来 实现 Robot Framework 中 Sting Lib 库 〈 如 图 6-2-11 所 示 ) 的 
部 分 关键 字 Convert To Lowercase 和 Convert To Uppercase。 


soon — 


Search term: Q, [VI Search documentation 
Source: (string - 

Name Source Description 3 

Convert To Lowercase Sting Converts string to lowercase. B 
Convert To Uppercase String Converts string to uppercase. M 
Decode Bytes To String String Decodes the given "bytes" to a Unicode string using. 
Encode String To Bytes String Encodes the given Unicode "string" to bytes using t.. 
Fetch From Left String Returns contents of the “string” before the first occu... 
Fetch From Right String Returns contents of the "string" after the last occurr.. 
Generate Random String String Generates a string with a desired "length" from the - | 
— faan Potman E P rd rod 

Name: Should Be String ` 


Source: String <test Ibrary> 
Arguments: [ Kem | msg=None ] 


m 


Fals if the given icem is not a string. 


This keyword passes regardless is the item is a Unicode string or a byte string, Use ` Should Be Unicode String" or 
“Should Be Byte String” f you want to restrict the string type. 


The default error message can be overridden with the optional msg argument. 


图 62-11 
package com.example.keywords; 
import org. robotframework.javalib.annotation.ArgumentNames; 


import org. robotframework.javalib.annotation.RobotKeyword; 
import org. robotframework.javalib.annotation.RobotKeywords; 


@RobotKeywords 
public class StringKeyWord { 


@RobotKeyword ("Convert To Lowercase") 
@ArgumentNames ({"string"}) 


public String convertToLowercase(String string) { 
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System.out.print ("Convert "+string+" To Lowercase") ; 


return string.toLowerCase(); 


GRobotKeyword ("Convert To Uppercase") 

@ArgumentNames (("string"]) 

public String convertToUppercase(String string) { 
System. out.print ("Convert "+string+" To Uppercas: 
return string.toUpperCase (); 


关键 字 编写 完了 之 后 ， 我 们 还 需要 定义 一 个 Library E (HEK AnnotationLibrary 类 ) ， 并 
且 通 过 RemoteServer 的 方式 来 启动 。 


package com.example; 

import java.io.IOException; 
import java.io.InputStream; 
import java.io.StringWriter; 
import java.nio.charset.Charset; 


import org.apache.commons.io.IOUtils; 
import org.robotframework.javalib.library.AnnotationLibrary; 
import org. robotframework.remoteserver.RemoteServer; 


public class MyRemoteLibrary extends AnnotationLibrary { 
public MyRemoteLibrary() { 
KEI GE 
super ("com/example/keywords/*.class") ; 


@override 
public String getKeywordDocumentation(String keywordName) { 
if (keywordName.equals(" intro ")) 
return getIntro(); 
return super.getKeywordDocumentation (keywordName); 


+ ERE LU HVE 

+ @param args 

+ Qthrows Exception 

*/ 

public static void main(String[] args) throws Exception { 

RemoteServer.configureLogging(); 
RemoteServer server = new RemoteServer(); 
// server FILA BXE X BJ library, FAKRBAZHEORA NRA 
server.addLibrary (MyRemoteLibrary.class, 8270); 
server.start(); 
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/** 


* ÆX Library [IEEE E 
* @return 


*/ 


private String getIntro() í 
try ( 
InputStream introStream 
MyRemoteLibrary.class.getResourceAsStream(" _intro__.txt"); 
StringWriter writer = new StringWriter(); 
IOUtils.copy(introStream, writer, Charset.defaultCharset()); 
return writer.toString(); 


) 
catch (Exception e) { 
throw new RuntimeException (e); 


定义 完 Library 后 , 就 可 以 以 RemoteServer 的 方式 来 启动 远程 接口 服务 , 如 图 6-2-12 所 示 。 


Run 
|a t “C:\Program Files\Java\jdki.8.0_101\bin\jave” 
m" O [nain] INFO org robotframework remoteserver RemoteServer — Added library com example MyRemoteLibrary 
cs main] INFO org robotfranework remoteserver RemoteServer — Robot Framework remote server starting 
Hs [nain] INFO org eclipse. jetty. server Server ~ jetty-7 6.3 v20120116 
D 901 [main] INFO org eclipse. jetty. server handler ContextHandler — started o ej. s ServletContextHandler (/, mull} 
Ag 局 903 [main] INO org apache xmlrpe webserver. InlRpcServlet ~ init 
» 1403 [main] IMFO org eclipse. jetty. server AbstractConnector — Started SelectChannelConnectorQO. 0. 0. 0:8270 


图 6-2-12 
在 RIDE 中 ， 我 们 通过 Remote 连接 到 启动 的 远程 接口 服务 中 ， 如 图 6-2-13 所 示 。 


| Edit | Text Edit | Run 


TestSuite11 

Source F:\project\RobotFrameworkTest1 \RobotFramework Test! V TestSuite1 1 .txt 
Import Name / Path Arguments Comment 

Library Remote 127.0.0.1:8270 


图 62-13 


然后 按 FS 快捷 键 ， 就 可 以 看 到 远程 服务 中 定义 的 关键 字 了 ， 如 图 6-2-14 所 示 。 
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Seard |Z Search documentation 


z) 

Description 
Convert To Lowercase Convert To Lowercase 
Convert To Uppercase Convert To Uppercase 
Stop Remote Server Stops the remote server. 


Name: Convert To Lowercase 
Source: Remote «test lbrary»- 
Arguments: [ string ] 


Convert To Lowercase 


6-2-14 


【示例 2】 调 用 远程 接口 服务 中 定义 的 关键 字 ， 如 图 6-2-15 所 示 。 


图 6-2-15 


Starting : RobotFrameworkTestl.TestSuitell.TestCase001 
20180822 :04:23.328 : INFO : Convert robotFramework To Lowercase 
20180822 :04:23.328 : INFO : ${strLowercase } = robotframework 


20180822 :04:23.330 : INFO : robotframework 


20180822 :04:23.337 : INFO : Convert robotframework To Uppercase 

20180822 :04:23.338 : INFO : ${strUppercase } = ROBOTFRAMEWORK 

20180822 :04:23.340 : INFO : ROBOTFRAMEWORK 
RobotFrameworkTestl.TestSuitell.TestCase001 


从 运行 结果 看 ， 可 以 成 功 调用 到 我 们 远程 接口 服务 中 自 定义 编写 的 两 个 关键 字 。 

上 面 我 们 通过 RemoteServer 的 方式 来 调用 Java 编写 的 自 定义 的 关键 字 。 我 们 也 可 以 改 用 
jybot 的 方式 来 调用 Java 编写 的 自 定义 关键 字 。 在 工程 中 ,我 们 引入 maven-assembly-plugin 这 
个 插件 ， 通 过 执行 mvn clean assembly:assembly -Dmaven.test.skip=true 在 打包 时 将 所 有 相关 的 
依赖 包 打 在 一 个 jar 包 中 。 这 样 我 们 在 执行 时 就 不 需要 手动 地 一 个 个 去 配置 执行 时 需要 依赖 的 
其 他 相关 jar 包 了 。 
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<properties> 
<!-— EXTI EI ITE ITE --> 
<project .build.sourceEncoding>UTF-8</project .build.sourceEncoding> 


<testLibraryClass>MyRemoteLibrary</testLibraryClass> 
</properties> 


<plugin> 
<artifactId>maven-assembly-plugin</artifactId> 
<configuration> 
<descriptorRefs> 
<descriptorRef>jar-with-dependencies</descriptorRef> 
</descriptorRefs> 
<archive> 
<manifest> 
!-- BEBÉ) java main ZE --> 
<mainClass>${testLibraryClass}</mainClass> 
</manifest> 
</archive> 
</configuration> 
<executions> 
<execution> 
<id>make-my-jar-with-dependencies</id> 
<phase>package</phase> 
<goals> 
<goal>single</goal> 
</goals> 
</execution> 
</executions> 


</plugin> 


另外 需要 注意 是 ， 我 们 需要 将 上 面 定 义 的 MyRemoteLibrary 类 移动 到 maven 工程 的 根 目 
录 下 ， 如 图 6-2-16 所 示 。 


v 有 src 
Y Remain 


Y Majava 


» fx comexample 
@ & MyRemoteLibrary 


图 6-2-16 


执行 mvn clean assembly:assembly -Dmaven.test.skip=true 打包 后 ， 就 可 以 生成 我 们 需要 的 
jar 包 了 ， 如 图 6-2-17 所 示 。 


E - 
Bi ordive-mp 

J classes 

de maven-archiver 


B maver-status. 


10jar 
10-jar-with-dependencies jar. 


Executable Jar File 7KB 


Executable Jar File — 4, 


6-2-17 


将 MyRemoteLibrary-1.0-jar-with-dependencies.jar 放置 到 Java 的 classpath 目录 下 , 我 们 就 
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可 以 在 RIDE 中 引入 MyRemoteLibrary 库 了 ， 如 图 6-2-18 所 示 。 


| Edit Text Edt | Run | 


Source F:\project\RobotFrameworkTest1 \RobotFrameworkTest! \ TestSuite1 1 txt 


Name / Path Arguments Comment 
MyRemoteLibrary 


6-2-18 


引入 后 ， 我 们 再 用 jybot 的 方式 执行 上 面 RemoteServer 运行 时 的 同样 示例 ， 如 图 6-2-19 
所 示 。 


图 6-2-19 


1 test to 


Bobo 
Peritical tent 1 pm 
ies 


test Finished 20100022 10.41.32 
ear 


Sharting test RobotFrameyork Tast! TestSuisett, TestCaset0ni 
EXPE HERE Conver! 


Ta Lovere: 
ise} + robot franewere 


Ser tobe: Cremever ee 
Strüppercese 


图 6-2-20 
JUAS, 3 


E 


行 后 得 到 了 同样 的 结 
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自动 化 测试 用 例 的 常用 技巧 


7.1.1 自动 化 测试 用 例 的 容错 

自动 化 测试 用 例 在 实际 执行 时 都 可 能 出 现 执行 失败 ,但 是 有 时 候 就 是 因为 某 一 条 测试 用 例 
执行 失败 了 ,从 而 影响 到 整个 测试 用 例 集 都 会 执行 失败 或 者 浏览 器 资源 无 法 得 到 释放 。 此 时 测 
试用 例 的 容错 就 会 变 得 非常 重要 。 

我 们 先 来 看 一 下 Selenium2Library 自动 化 测试 库 中 Register Keyword To Run On Failure 关 
键 字 这 个 例子 。 


Open Browser https://www.baidu.com/ chrome 


Register Keyword To Run On Failure Close Browser 
Mouse down id-kwlll 


Close Browser 


在 这 里 , 我 们 故意 设置 了 一 个 肯定 会 执行 失败 的 场景 , 因为 在 执行 Mouse down 这 个 关键 
字 时 ， 通 过 locator 为 id=kw111 在 页 面 中 根本 定位 不 到 任何 元 素 ， 如 图 7-1-1 所 示 。 此 时 间 题 
就 来 了 ,测试 用 例 肯 定 会 执行 失败 ,然后 案例 就 会 退出 , 但 是 退出 时 并 不 会 将 浏览 器 关闭 、 释 
放 资 源 。 

此 时 Register Keyword To Run On Failure 关键 字 的 设置 就 非常 关键 了 ， 它 可 以 在 执行 失败 
时 让 Selenium2 做 关闭 浏览 器 操作 。 

在 实际 执行 上 面 的 那 条 测试 用 例 步 又 时 ,我 们 可 以 看 到 使 用 了 这 个 执行 容错 关键 字 后 浏览 
器 是 可 以 关闭 的 。 如 果 没 有 这 个 关键 字 ， 那 么 在 执行 失败 时 浏览 器 根本 不 会 关闭 。 
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| FAIL | 


IDEvyt 
appdata local’ RIDEvyf: log htaj 

Report: cows 'ongqing"aprdata" local\tenp\RIDEvyfrba dreport html 
test finished 20180723 15:15:08 
at 

Starting test; RobotFransvor! kTeoti TootSu:toé Test Cass0020 

20180729 15:14:53.899 : INFO ; Openi 

0180729 15.15.06.635 | INF ose 


H 
20180729 15:15:06.636 : INFO ; Simula 
20160723 19:18:07.989 | FAIL | ERROK. Element idckwlll not found 
Ending test: — RobotFrameworkTestl.TestSuite$ TestCase0030 


7-1-1 
表 7-1-1 中 列 出 了 Robot Framework 中 常用 的 和 容错 相关 的 关键 字 


表 7-1-1 Robot Framework 中 常用 的 和 容错 相关 的 关键 字 


使 用 描述 

在 Selenium2Library 库 和 AppiumLibrary 库 中 都 有 一 个 这 样 的 关键 
字 ， 可 以 帮助 我 们 在 使 用 Selenium2 或 者 Appium 执行 对 浏览 器 或 
者 移动 手机 操作 时 在 执行 失败 的 情况 下 可 以 做 的 一 些 容错 处 理 

这 个 关键 字 来 源 于 BuiltIn 库 ， 这 个 库 是 默认 自动 加 载 的 ， 不 需要 
通过 import 的 方式 来 导入 。 这 个 关键 字 可 以 指定 操作 执行 失败 时 
继续 往 下 执行 

这 几 个 关键 字 同样 来 源 于 BuiltIn 库 。 这 个 库 默 认可 以 自动 加 载 ， 
不 需要 通过 import 关键 字 来 导入 指定 库 。 这 些 关 键 字 主要 用 于 在 
关键 的 测试 执行 失败 时 指定 需要 执行 的 关键 字 操 作 并 且 该 关键 字 
只 能 使 用 在 测试 用 例 集 Suite 中 。 在 Robot Framwork 的 每 一 个 测试 
用 例 集 suite 中 都 可 以 进行 Suite Setup 对 测试 用 例 集 的 初始 执行 
操作 ， 只 会 执行 一 遍 ) 和 Suite Teardown (Run Keyword If Any 
Critical Tests Failed 关键 字 一 般 就 可 以 用 于 此 处 ) 设置 

在 每 一 个 Suite 中 ， 我 们 还 可 以 设置 Test SetUp《〈 该 测试 用 例 集 下 
的 每 一 个 案例 在 初始 执行 时 都 会 执行 的 初始 化 操作 ) 和 Test 
Teardown 〈 该 测试 用 例 集 下 的 每 一 个 测试 用 例 在 执行 结束 时 都 会 
执行 的 操作 ) 以 及 Test TimeOut (该 测试 用 例 集 下 的 每 一 个 自动 化 
测试 用 例 执行 超时 时 可 以 设置 执行 的 操作 〉 处 理 

Run Keyword If Timeout Occurred 该 关键 字 和 上 面 的 那 几 个 类 似 .这 个 关键 字 主要 是 解决 案例 执行 超 
时 ， 可 以 指定 在 超时 发 生 时 执行 何 种 关键 字 操 作 ， 在 处 理 容错 时 经 
常会 用 到 。 这 个 关键 字 用 于 在 Robot Framwork 每 一 个 测试 用 例 集 
Suite 的 Suite Teardown 设置 中 


关键 字 
Register Keyword To Run On Failure 


Run Keyword And Continue On Failure 


Run Keyword If Any Critical Tests 
Failed 和 Run Keyword If Any Tests 
Failed 以 及 Run Keyword If Test Failed 
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7.1.2 自动 化 测试 用 例 的 测试 数据 初始 化 和 脏 数 据 的 处 理 


在 自动 测试 中 , 数据 的 初始 化 操作 以 及 案例 执行 完成 后 需要 对 部 分 脏 数据 进行 清理 ， 以 免 


影响 下 一 次 测试 用 例 的 执行 操作 或 者 对 别 的 测试 用 例 的 执行 造成 影响 。 


COD 通过 执行 数据 库 脚本 来 进行 数据 库 中 数据 的 初始 化 操作 和 脏 数 据 的 清理 
在 Robot Framework 中 ，DatabaseLibrary 库 中 的 Execute Sql Script 关键 字 和 Execute Sql 


String 关键 字 都 可 以 用 来 完成 数据 初始 化 操作 和 脏 数据 的 清理 操作 。 


(2) 通过 OperatingSystem 库 来 对 自动 化 测试 用 例 执行 过 程 需要 的 文件 数据 做 初始 化 操 
作 ， 以 及 执行 完成 后 文件 脏 数据 的 清理 。 
K 7-1-2 中 列 出 了 RobotFramework 中 常用 的 和 数据 清理 相关 的 关键 字 。 


表 7-1-2 RobotFramework 中 常用 的 和 数据 清理 相关 的 关键 字 


关键 字 


Append To Environment 
Variable 


Remove Environment 
Variable 


Copy Directory 


Copy File 


Copy Files 


Move Directory 
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该 关键 字 用 来 增加 一 个 操作 系统 的 环境 变量 ， 接 收 [ name | *values | **config ] 
这 些 参 数 。 示 例 : 


Fe asa Variable 


[ should Be Equal — | 


该 关键 字 用 于 删除 指定 的 系统 环境 变量 ， 接 收 [ "names ] 多 个 参数 ， 即 可 以 支持 
删除 多 个 环境 变量 。 示 例 ; 


T 
Variable 


该 关键 字 用 于 做 文件 夹 的 复制 操作 ， 接 收 [ source | destination ] 两 个 参数 ， 如 果 
destination 参数 对 应 的 文件 夹 已 经 存在 ， 就 将 source 参数 对 应 的 文件 夹 复制 到 
destination 参数 对 应 的 文件 夹 下 面 ， 否 则 复制 过 去 后 直接 创建 一 个 新 文件 夹 。 
示例 : 


/home/robottest1 /home/robottest2 


该 关键 字 用 于 复制 文件 操作 ， 接 收 [ source | destination ] 两 个 参数 ， 如 果 
destination 参数 对 应 的 文件 已 经 存在 ， 就 直接 覆盖 ， 和 否则 直接 复制 过 去 创建 一 
个 新 文件 。 示 例 : 

Copy File | /home/robottest] txt | /home/robottest2.txt 
该 关键 字 用 于 复制 多 个 文件 操作 ， 接 收 [ *sources_and destination ] 多 个 参数 。 复 
制 时 ,可 以 传 入 多 个 文件 参数 , 但 是 最 后 一 个 参数 必须 是 一 个 目标 文件 夹 路 径 。 
示例 : 

Copy Files 


/home/robott 
est] txt 


/home/robott 
esto txt 


/home/robott 

est3.txt 

该 关键 字 用 于 做 文件 夹 的 移动 操作 , 接收 [ source | destination ] 两 个 参数 。 示 例 ; 
Move Directory /home/test1 | /home/test2 


/opt/ 
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( 续 表 ) 
关键 字 使 用 描述 

Move File 该 关键 字 用 于 做 文件 的 移动 操作 ， 接 收 [ source | destination ] 两 个 参数 ， 示 例 ; 

Move File /home/robottest] txt | /opt/ 

Move Files 该 关键 字 用 于 做 多 个 文件 的 移动 操作 ， 接 收 [ *sources and destination ] 多 个 参 
数 。 可 以 移动 多 个 文件 ， 但 是 传 入 的 最 后 一 个 参数 必须 是 一 个 目标 文件 夹 路 径 。 
示例 : 

Move Files /home/robottest1 txt /home/robottest2 txt | /opt/ 

Append To File 该 关键 字 用 于 向 指定 文件 内 追加 内 容 ， 接 收 [ path | content | encoding-UTF-8 ]= 
个 参数 ， 如 果 指 定 的 路 径 文件 不 存在 ， 就 新 创建 一 个 文件 ， 如 果 文 件 已 经 存在 ， 
就 直接 追加 内 容 , 并且 可 以 指定 追加 内 容 的 字符 集 格式 ， 默 认为 UIF-8。 示 例 ; 

nd To File /opt/test.txt Robot framework 

Remove Directory 该 关键 字 用 来 删除 一 个 指定 的 文件 夹 目录 ， 接 收 [ path | recursive=False ] 两 个 参 


数 。recursive 参数 用 来 判断 是 否 需要 进行 递归 删除 ， 设 置 为 否 时 ， 当 指定 路 径 
下 存在 子路 径 或 者 文件 时 将 无 法 删除 。 示 例 : 


/home/test 


Remove File 该 关键 字 用 来 删除 指定 的 文件 ， 接 收 [path ] 一 个 参数 。 示 例 ; 


Joptiest.tx 


Remove Files 该 关键 字 用 来 删除 多 个 指定 的 文件 ， 接 收 [ *paths ] 多 个 参数 。 示 例 : 


/home/robottest] txt /home/robottest2.txt 


OperatingSystem 库 还 有 Count Directories In Directory. Count Files In Directory, Count Items 
In Directory, Create Binary File. Create Directory. Create File. Empty Directory. Get File, Get 
File Size, Get Modified Time. Grep File, Join Path. Join Paths, List Directories In Directory. 


List Directory, List Files In Directory. Touch, Split Path, Split Extension, Directory Should Be 
Empty. Directory Should Exist. Directory Should Not Be Empty. Directory Should Not Exist, File 
Should Be Empty. File Should Exist. File Should Not Be Empty. File Should Not Exist, Split 
Extension 等 关键 字 ， 在 我 们 做 文件 类 数据 的 初始 化 和 数据 清理 时 能 提供 很 大 的 帮助 。 


如 何 高 效 地 维护 好 自动 化 测试 用 例 


7.2.1 提取 出 共用 变量 统一 维护 


在 自动 化 测试 中 ， 经 常 需要 使 用 到 变量 ， 也 经 常 需要 定义 变量 。 在 Robot Framework 中 ， 
可 以 定义 单个 变量 ， 也 可 以 通过 列表 或 者 字典 的 方式 来 定义 我 们 需要 的 变量 。 
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在 一 个 测试 用 例 集中 , 多 个 案例 都 需要 用 到 的 变量 可 以 放 到 测试 用 例 集中 进行 统一 定义 和 
维护 。 图 7-2-1 所 示 就 是 一 个 测试 用 例 集 的 界面 。 通 过 Add Scalar、Add List、Add Dict 定义 出 
来 的 变量 都 是 对 整个 测试 用 例 集 共用 的 变量 。 


RTV 


Tessute2 
Tessutes 
TesSutet 
TestSuts5 


ETG Tescaseoom 
E] Tescasecone 


图 7-2-1 


【示例 1] FH Add Scala 定义 出 来 的 测试 用 例 集 都 能 共用 的 变量 。 
定义 一 个 ${bookname} 变 量 ， 如 图 7-2-2 所 示 。 


ao MEN... 
Name S(bookname) 
Vale Robot FrameWork 


Comment — $55 
(Give name and value of the variable. 


Cox) (cancel) 
图 7-2-2 


定义 成 功 后 ， 界 面 上 会 展示 定义 好 的 变量 ， 如 图 7-2-3 所 示 。 


3 


anm 


a 

a 

A Tescasexis 
A Testcaseaci4 
a 
a 
a 
a 
a 


oa 


7-2-3 
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定义 完成 后 ， 再 在 这 个 测试 用 例 集 下 建立 一 个 测试 用 例 来 使 用 变量 ， 如 图 7-2-4 所 示 。 


log 书 名 是 : S(bookname) 
Should Be Equal ${bookname} Robot FrameWork 
7-2-4 


运行 上 面 的 测试 用 例 后 ， 结 果 如 图 7-2-5 所 示 。 


Te 
hailed 


RobotFramoworkToat | Pass | 
1 critical test, 1 passed, 0 failed 

1 test total, 1 passed, 0 failed 

Output: c:vusers vonading"eppdata loca] Vtemp RIDEbd9idf .d\output. xw] 

los 5 Nussrs\yongaingsappdata\ Ines |\temp\RIDEbd93df d\log htal 
Report: ©:\usere\yongqing\appdats® loca!\temp\RIDEbd93d£ .d\report -btnl 
test finished 20100904 11.11.92 


Storting toar; obotFroncvorkTosti ToatSui tat ,TeotCaao0013 
gotsoood 1111:42 $us NFO. 9s 
n. 


d test. Robot Prenoyenktasts TestSui toe, TeStcase6033 
-2-5 
从 运行 结果 可 以 看 到 ， 在 测试 用 例 集中 定义 的 共用 变量 可 以 在 单个 测试 用 例 中 直接 引用 。 


如 果 在 测试 用 例 中 也 定义 了 一 个 和 测试 用 例 集 重 名 的 变量 ,那么 这 个 变量 会 直接 缆 盖 测试 
用 例 集 中 的 已 有 变量 ， 如 图 7-2-6 所 示 。 


Robot 
FrameWork 自 动 化 出 试 框架 核心 指南 


Robot FrameWork 


运行 结果 如 下 : 
Starting test: RobotFrameworkTestl.TestSuite6.TestCase0034 
20180804 11:19:23.920 : INFO : ${bookname} = Robot FrameWork 自动 化 测试 框架 核心 指 
Lj 


20180804 11:19:23.921 : INFO : 书 名 是 : Robot Framework 自动 化 测试 框架 核心 指南 


20180804 11:19:23.922 : FAIL : Robot FrameWork 自动 化 测试 框架 核心 指南 != Robot 
FrameWork 


Ending test: 


RobotFrameworkTestl.TestSuite6.TestCase0034 


从 运行 结果 看 ， 在 测试 用 例 中 定义 的 重 名 变量 已 经 被 直接 覆盖 掉 了 。 
【示例 2】 通 过 Add List 来 定义 测试 用 例 集 都 共用 的 List 变量 。 
定义 一 个 性 别 类 型 的 @{sex}List 变量 ， 如 图 7-2-7 所 示 。 
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List Variable Å= 
Name ee) 
Vale m x +a 
| Columns. 
| E] - 
[Comment a 
Give name and value of the variable. Input list variable items into separate cells. 
Cx] 
7-2-7 
定义 成 功 后， 界面 上 可 以 展示 定义 好 的 List 变量 ， 如 图 7-2-8 所 示 。 
RIDE Tortu; 
Ele Edi: Tools Navigate Mecros Help 
[oS PERAK T w 
Go TestSute2 ^ | El Toc cae mur arx 
Geo Testsute3 E 
a TestSutet TestSuite6 
aa Source F \oroect Robettramewore Testi \RbotFrameworkTest:\TestSute5. bt 
日  sTessutes 
b s(bookname) Setungs >> 
图 | 
加 Ë Testcasecoo: Import Name / Path Arguments Comment Acd mper 
Un Seleniam2Uibrary Upany 
nm string Eee _ ] 
Hh CL Library OperetinaSystem 
El 和 restcasecoos 
El Ñ Testcase0007 s deor Faded Haly. 
E Ñ restcasecoos T J 
E 8 Tostcasoco09 — & F 
J rasa Variable Vous Commert M Sear 
回 Tostcasecon: Sibookrame) Robot FrameWork £ 48% SS 
E rescasecoi2 Bisex) Bi xix LE] 
El Taxcaeecol3 Acá Diet 
El Ñ rescaseooi 
E) Ñ Teacxeools 
E rescasecoie. 
E rescasicoi 
E) Ñ rescxecols 
E rescasecoto. — | Metadata. Value Commert. Add Metadata 
FI Tescasenon 
图 7-2-8 


我 们 再 写 一 个 简单 的 测试 用 例 ， 用 来 调用 测试 用 例 集中 定义 的 共用 List 变量 ， 如 图 7-2-9 
所 示 。 


图 7-2-9 


运行 结果 如 下 : 


Starting test: RobotFrameworkTestl.TestSuite6.TestCase0035 


20180804 15:24:07.569 : INFO : 性 别 : 男 

20180804 15:24:07.571 : INFO : 性 别 : £ 

20180804 15:24:07.573 : INFO : 性 别 : 未 知 

Ending test: ^ RobotFrameworkTestl.TestSuite6.TestCase0035 


722 在 单个 自动 化 测试 用 例 中 多 使 用 变量 


上 面 提 到 了 要 提取 共用 的 变量 统一 维护 , 除 共用 的 变量 外 , 我 们 在 每 一 个 测试 用 例 中 也 需 
要 尽量 多 定义 自己 的 变量 , 而 且 这 些 变量 尽量 定义 到 案例 的 开始 步骤 中 , 这 样 后 面 在 维护 案例 
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时 就 会 高 效 很 多 。 比 如 一 个 案例 运行 的 期 望 值 可 能 会 发 生变 化 , 那么 我 们 修改 的 时 候 就 直接 修 
改定 义 的 变量 值 ， 而 不 需要 在 一 大 堆 很 长 的 步骤 中 去 找 。 我 们 来 看 一 个 示例 ， 如 图 7-2-10 所 
示 。 


Be Equal Sbte) S(expectedTite) BERE: siete 


1 S(expectedTitie + 


7-2-10 


在 这 个 示例 中 ， 由 于 我 们 提取 了 变量 ， 因 此 后 期 在 维护 案例 时 会 方便 很 多 。 


7.2.3 ”提取 复 用 的 业务 或 者 步骤 ， 封 装 自 定义 的 用 户 关键 字 


在 自动 化 测试 用 例 中 ， 经 常会 出 现 一 些 步骤 是 共用 的 《很 多 案例 中 都 需要 使 用 的 步骤 ) ， 
我 们 可 以 把 这 些 步骤 提取 出 来 ， 而 不 是 在 每 个 测试 用 例 中 都 重复 编写 这 些 测试 步骤。 抽取 成 共 
用 后 , 可 以 封装 成 自己 定义 的 用 户 关键 字 , 在 其 他 的 测试 用 例 中 直接 使 用 这 个 自 定义 的 用 户 关 
键 字 即 可 。 这样 以 后 共用 的 步骤 发 生变 化 后 ， 就 不 需要 每 一 个 测试 用 例 都 去 做 修改 了 ， 只 需要 


修改 自 定义 的 用 户 关 键 字 即 可 。 如 图 7-2-11 所 示 , TE RIDE 界面 上 选中 一 个 测试 用 例 集 后 ， 右 
击 鼠 标 键 ， 选 择 “New User Keyword” 选 项 ， 即 可 新 建 一 个 自 定义 的 用 户 关键 字 。 


New Test Case -Shift-T 
New User Keyword CerLshikK 
New Sealar Ctrl-Shift-v 
New List Variable Ctrl-Shift-L 
New Dictionary Variable 


* 
z 


Rename F2 
Change Format 

Sort Keywords 

Delete 

Select All Teste 

Deselect All Tests 

Select Only Failed Tests 

Select Only Passed Tests 


Search Keywords 


[b bbbbbbbPPbbbbPbb? 


° 
° 
1 

J 

1 

1 

1 
F 
1 

J 

1 
m 
1 
El 
1 
El 
1 
= 


图 7-2-11 
下 面 我 们 将 一 个 登录 百度 的 操作 封装 成 一 个 通用 的 自 定义 用 户 关键 字 。 登 录 本 身 是 一 个 通 
用 的 步骤 ,很 多 案例 都 需要 先进 行 登录 ， 这 里 将 关键 字 的 名 字 定 义 为 login baidu。 我 们 让 该 关 
键 字 接收 两 个 参数 ， 用 户 名 $ {user} 和 密码 ${passwd}， 因 为 登录 时 肯定 是 需要 输入 用 户 名 和 密 
码 的 ， 如 图 7-2-12 所 示 。 
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login baidu 
S{user}|${passwd} 


图 7-2-12 


[etuer eased) | 


图 7-2-13 


之 后 ， 我 们 就 可 以 在 该 关键 字 中 将 登录 操作 步骤 加 进去 ， 如 图 7-2-14 所 示 。 


Open Browser http://www.baidu.com chrome 

Click Element //* (@id="u1"]/a[7] 

Sleep 2 

Click Element id-TANGRAM PSP 10 footerULoginBtn 

Input Text | id-TANGRAM PSP 10 userName ${user} 

Input Password id-TANGRAM PSP 10 password ${passwd} 
Click Button id=TANGRAM PSP 10 submit 


Documentation 这 是 一 个 芋 孙 百度 的 操作 。 


Tags “<add New> | 
par iSuser) | Spas] 


图 72-14 


关键 字 定义 好 了 以 后 ， 就 可 以 在 测试 用 例 中 使 用 自己 定义 的 关键 字 了 。 如 图 7-2-15 所 示 ， 
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我 们 定义 了 一 个 测试 用 例 ， 并 使 用 login baidu 自 定义 的 关键 字 。 


login baidu yongging zh 123456 

Sleep ao | 

Cose browser E === 1 
图 72-15 


执行 测试 用 例 ， 运 行 结果 如 图 7-2-16 所 示 ， 可 以 看 到 调用 自 定 义 封 装 的 关键 字 成 功 了 。 


Starting test: RobotFrameworkTestl.TestSuite9.TestCase0001 

20180804 16:41:20.508 : INFO : Opening browser 'chrome' to base url 
'"http://www.baidu.com" 

20180804 16:41:28.557 : INFO : Clicking element '//*[8Gid-"u1"]/a[7]'. 
20180804 16:41:30.712 : INFO : Slept 2 seconds 

20180804 16:41:30.713 : INFO : Clicking element 

'id-TANGRAM PSP 10 .footerULoginBtn'. 

20180804 16:41:32.908 : INFO : Typing text 'yongding zh' into text field 
'id-TANGRAM PSP 10 userName’ 

20180804 16:41:33.105 : INFO : Typing password into text field 
'id-TANGRAM PSP 10 password’ 

20180804 16:41:33.282 : INFO : Clicking button 'id-TANGRAM PSP 10 submit’. 
20180804 16:41:44.326 : INFO : Slept 10 seconds 

Ending test: RobotFrameworkTest1.TestSuite9.TestCase0001 


图 7-2-16 


724 封装 全 局 可 用 的 资源 文件 


从 前 面 可 以 知道 , 很 多 共用 的 封装 都 是 针对 单个 测试 用 例 集 共 用 的 , 那么 如 何 封装 多 个 测 
试用 例 集 都 可 以 重用 的 步骤 或 者 变量 定义 呢 ? 这 里 就 需要 用 到 Resource 了 。 选 中 我 们 的 自动 
化 测试 工程 ， 右 击 鼠 标 键 ， 选 择 New Resource 选项 就 可 以 建立 一 个 Resource 了 ， 如 图 7-2-17 
所 示 。 
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Edt | Run 
= Test1 
E FlprojectRobotFramewokTestilRobotFrameworkTesti 
te New User Keyword onse p) 
TE New salar arshitv P 
j ments mm 
Ta New list Variable Crisis Nimas Deh. m Savat: 
aTe New Dictionary Variable 
9 asl Change Format 
Ə DTe  SeledAlTess 
a B. Deseler Al Tess 
"| — Select Only Failed Tests 

Select Only Passed Tests 

Expard all 

Collapse all 


7-2-17 
在 弹出 的 窗口 中 输入 Resource 名 称 就 可 以 定义 一 个 Resource 了 ， 如 图 7-2-18 所 示 。 
New Resource File i = 
coe ow om 


Croatod Path 


7-2-18 


定义 好 一 个 Resource 后 ， 界 面 展 示 如 图 7-2-19 Aras. 


megas r o 
日 回 RobetrameworkTestl ax 
Gi Testsutet 
加 Testsuke2 Fneuages 
ai) Texsukel F:\projact\RobotFrameworkTastl RobctFrameworkTast1 ry resource. t 
@ | Testsutes 
G | Testsutes 
Tastsuka6 一 


Testsute7 
lame / Ps ume 
hed Name / Path Arguments 


TestSuted Seleriu2tibrary 


IË Exteral Resources 


B 7-2-19 
TE Resource 中 我 们 可 以 定义 的 操作 如 下 : 


€ 导入 需要 的 Library 库 。 在 图 7-2-19 中 ， 我 们 导入 了 Selenium2Library Æ. 
e 引用 已 经 定义 好 的 其 他 Resource。 
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€ ZA Resource 下 共用 的 单个 变量 、List 变量 和 Dictionary € €. 
€ ZA Resource 下 自 定义 的 用 户 关键 字 。 


这 里 我 们 将 之 前 定义 的 login baidu 关键 字 复 制 到 我 们 自己 定义 的 Resource 下 面 ， 如 图 
7-2-20 所 示 。 


File Edit Tools Navigate Macros Help 
SOREBEBRKT + » 
© RobotrrameworkTest: [tat] Text ede | Run | 
Tt 
Ta login baidu 
Teen 
Tees 
Tt 
Testes 
Tesis 
Tessute] 
TestSuteB. 
Tezsute9 
s am 
Dita tsa] 


Z) extemal Resources 


TIC] 


meg 


hitpxjfvews bau con. 
Irie T7 
2 


Jd-TANGRAM, PS 16, focterüLogrDn Gw 


JdeTANGUM. PSP 10 iserlime Se 
UdCTANGUM POP 0 pasoword ed 


CE == 


图 7-2-20 
然后 我 们 新 建 一 个 测试 用 例 集 ， 并 且 在 该 测试 用 例 集中 引入 该 Resource， 如 图 7-2-21 所 


不 。 


1E -Di Roboterameworcresti 
TestSuteL 


Testsutez FlprojectiRobotFrameworkTesti RobotFrameworcTestirestSute10.txl 
TestSuke3 
Testsutet 
Testsutes 
TestSuites 
TestSuite? 
Testsute8 
Testsute5 

d) my ramurcebe 
9 bgn baidu 

(3f tema Resources 


四 四 四 回回 回 由 由 由 由 外 


Commert x Aad Sear] 


Commert. [Aca metadata 
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在 导入 Resource 后 ， 我 们 就 可 以 使 用 导入 的 Resource 中 的 关键 字 了 。 如 图 7-2-22 所 示 ， 
我 们 新 建 了 一 个 测试 用 例 ， 直 接 使 用 Resource 中 的 自 定义 关键 字 。 


+ 
+ 
* 
+ 


Bm resourca .Dre 
39 con badu 
图 extemal Resources 


图 7-2-22 


运行 测试 用 例 ， 结 果 如 下 : 


Starting tes RobotFrameworkTest1.TestSuitel0.TestCase0001 

20180804 17:18:34.520 : INFO : Opening browser 'chrome' to base url 
"http: //www.baidu.com' 

20180804 17:18:43.266 : INFO : Clicking element '//*[@id="ul"]/a[7]'. 
20180804 17:18:45.455 : INFO : Slept 2 seconds 

20180804 17:18:45.456 : INFO : Clicking element 
'id-TANGRAM PSP 10 .footerULoginBtn'. 

20180804 17:18:47.227 : INFO : Typing text 'yongding zh' into text field 
'id-TANGRAM PSP 10 userName’ 

20180804 17:18:47.436 : INFO : Typing password into text field 
'id-TANGRAM PSP 10 ;fpassword' 

20180804 17:18:47.625 : INFO : Clicking button 'id-TANGRAM PSP 10 submit'. 
20180804 17:18:58.296 : INFO : Slept 10 seconds 

Ending test: | RobotFrameworkTestl.TestSuitel0.TestCase0001 
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Jenkins 下 自动 化 测试 的 调度 管理 


8.1.1 Jenkins 介绍 


Jenkins 是 一 个 功能 非常 强大 的 持续 集成 和 持续 交付 的 开源 项 目 ， 几 乎 可 以 处 理 任何 类 型 
的 自动 构建 或 者 持续 集成 。Jenkins 可 以 用 于 自动 化 部 署 ， 也 可 以 用 于 自动 化 测试 的 调度 。 通 
过 访问 网 址 https://jenkins.io/ 可 以 进入 Jenkins 的 官网 ， 如 图 8-1-1 所 示 。 


Meet the Jenkins 
project 
Join the Jenkins project at 


DevOps World - Jenkins World for a 
Contributor summit, workshops, ask the experts, 


ae multiple days of Jenkins related talks. Join es Je n ki n S Wo rl ^ 


* San Francisco, CA: september 16-19th 
* Nice, France: October 22-251h 


Register today 


8-1-1 


Jenkins 是 支持 常见 的 Master-Slave 架构 的 持续 集成 项 目 ， 很 多 开源 项 目 都 使 用 了 这 


ak 
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见 的 运行 架构 , 比如 大 数据 中 常用 的 Hadoop 项 目 等 都 用 了 这 一 运行 架构 。 在 Jenkins 中 , Master 
节点 可 以 用 来 负责 Slave 节点 的 管理 、 用 户 提交 的 Job 的 配置 以 及 把 Job 分 发 到 不 同 Slave + 
点 上 进行 运行 的 调度 和 管理 ， 如 图 8-1-2 所 示 。 


Master 
Slavet(Windows) Slave2(Windows) Slave3(Linux) Slaved(Linux) | | — ss 
8-1-2 


图 8-1-3 是 一 个 Jenkins 主 从 关系 的 架构 图 .用 户 可 以 通过 登录 到 Jenkins 的 Master 管理 界 
面 中 去 进行 节点 的 配置 管理 、Jenkins 的 插件 管理 、Job 任务 的 配置 和 分 发 、Jenkins 用 户 的 管 
理 、 系 统 运行 的 监控 以 及 Jenkins 的 系统 全 局 设置 等 操作 。Jenkins 也 提供 了 REST API 的 方式 
供用 户 或 者 其 他 系统 来 调用 Jenkins。API 有 XML API、JSON API 以 及 Python API 三 种 不 同 


的 表现 类 型 。 
—— | 
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图 8-1-3 


Jenkins 在 安装 完成 并 且 启 动 成 功 后 ， 可 以 通过 访问 ol 地 址 
(http://localhost:8080/jenkins/user/admin/api/) 来 获取 API， 如 图 8-1-4 所 示 。 
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€ > QC glocalhosts0 


Jenkins» admn » API IB 


REST API 


Many objects of Jenkins provide the remote access API. They are available at / jerkins/..../ Di/ where `.. portion ss the object for which you'd ike to access. 


XML API 
Accoss data 


osod in HTML as XML for machine consumption. Schema is also available 


You ean 3 


‘specify optional XPath to control the fragment you'd like to obtain (out see below) For example .. /api/xnl epath=/+/«{0] 


For XPath that matches multiple noces. you need to also specify the "wrapper" query parameter to specify the name of the root XML element to be create so that the resulting XML 
becomes well-formed 


Similarly sgolude query paramater can bo used to exclude nodes that match the given XPath from the result. This is useful for trimming down the amount of data you fetch (but again 
see below). This query parameter can be specified multpie times. 


XPath filtering is powerful, and you can have it only retum a very small data, but note that the server stil has to build a full DOM of the raw data, which could cause a large memory 
spiko. To avoid overloading the server, consider using the treo parameter, or use the xpath parameter in conjunction with the treo parameter. When used togothor, tho result of tho 
tree parameter fitering is bult into DOM, then the XPath is applied to compute the final retum value In this way. you can often substantially reduce the size of DOM built in memory 


JSON API 
Access the same data as JSON for JavaScript based accoss. tree may bo usod. 
Python APL 


Access the same data as Python for Python clients. This can be parsed into Python object as eval (url1ib. urlopen("..."). read) and the resulting object tee is identical to that 
of JSON. However, when you do this, beware of the security implication. If you are connecting to a nen trusted Jenkins, the server can send you malicious Python programs. 


in Python 2 6 or later you can safely parse this output using ast. Literal evil (ur lib. url pen(-. ..). res40) 


For more information about remote API in Jenkins. see the documentation 
Controlling the amount of data you fetch 


The tree query parameter allows you to explicitly specify and retneve only the information you are looking for, by using an XPathish path expression. The value should be a list of property 


names to include, with sub-properties inside square braces. Try ireesjots[name] views|name jobs[name]] to see just a Is! of jobs (only gving the name) and views (gving the name and 
jobs they contain) Note for ype properties (such as js is example). the name must be given in the original plural net in the singular as the element wuld appear in XML 


(<30t0). This will be more natural for e.c. jsor7ree-jobs[namej anyway: the JSON writer does nct do plura-to-sincular mangling because arrays are represented explicitly 


For array-type properties. a range specifier s supported. For example, tces- jubs [nana] (0,10) would retrieve the name of the first 10 jobs. The range specifier has the following variants. 


8-1-4 


通过 访问 网 址 https://python-jenkins.readthedocs.io/en/latest/api.html 可 以 获取 Python API 
相关 的 帮助 信息 。 
常见 的 Jenkins Python API 介绍 如 表 8-1-1 所 示 。 


表 8-1-1 常见 的 Jenkins Python API 


名 称 描述 

get_job_info 获取 某 个 Jenkins 任务 的 相关 信息 ， 获 取 到 的 任务 信息 将 以 Python 字典 的 形式 返 

辣 ， 相 关 的 参数 包括 : 

© name: 任务 的 名 称 ， 传 入 的 是 一 个 String 类 型 字符 囊 

€ depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 0 

© fetch all builds: 是 否 获取 该 Jenkins 任务 下 的 所 有 构建 任务 信息 ， 默 认为 
False， 传 入 的 是 一 个 布尔 值 类 型 参数 

get_job_info regex 这 是 一 个 通过 正则 表达 式 来 模糊 查询 Jenkins 任务 信息 的 接口 ， 获 取 Jenkins 的 任 

务 信息 能 与 指定 正则 表达 式 相 匹配 的 相关 任务 信息 ， 结 果 会 以 Python List 的 形式 

返回 ， 相 关 的 参数 包括 : 

€ pattem: String 类 型 的 正则 表达 式 

© depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 0 

© folder depth: 搜索 目录 的 深度 ， 传 入 的 也 是 int 类 型 ， 默 认为 0 

get_job_name 获取 Jenkins 任务 的 名 称 ， 相 关 的 参数 包括 : 

@ name: String 类 型 的 任务 名 称 
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(BER) 

名 称 描述 
debug job info 获取 某 个 job 更 多 的 debug 级 别 的 详细 信息 ， 相 关 的 参数 包括 : 

9 job name: Jenkins 任务 的 名 称 
get_queue item 获取 job 任务 的 队列 信息 ， 结 果 以 Python 字典 的 形式 返回 ， 相 关 的 参数 包括 : 

© number: 队列 的 大 小 ， 传 入 的 是 int 类 型 

€ depth: JSON 的 深度 ， 传 入 的 是 int 类型， 默认 为 0 
get_build_info 获取 某 个 Jenkins 任务 的 构建 信息 ， 结 果 以 Python 字典 的 形式 返回 ， 相 关 的 参数 包 


括 : 
© name: Jenkins 任务 的 名 称 ， 传 入 的 是 String 类 型 的 字符 事 
@ number: Jenkins 任务 的 构建 编号 ， 传 入 的 是 int 类 型 

e depth: JSON 的 深度 ， 传 入 的 是 int 类型， 默认 为 0 
get build test report | 获取 某 个 任务 构建 的 测试 报告 ， 结 果 以 Python 字典 的 形式 返回 ， 相关 的 参数 包括 : 
9 name: Jenkins 任务 的 名 称 ， 传 入 的 是 String 类 型 的 字符 囊 
@ number: Jenkins 任务 的 构建 编号 ， 传 入 的 是 int 类 型 


9 depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 0 
get build env vars 获取 某 个 Jenkins 任务 构建 的 环境 变量 信息 ， 结 果 以 Python 字典 的 形式 进行 返回 ， 
相关 的 参数 包括 : 
© name: Jenkins 任务 的 名 称 ， 传 入 的 是 String 类 型 的 字符 囊 
@ number: Jenkins 任务 的 构建 编号 ， 传 入 的 是 int 类 型 
© depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 0 


cancel_queue 取消 一 个 构建 队列 中 的 任务 ， 相 关 的 参数 包括 : 
€ id 一 个 待 构建 的 Jenkins 任务 的 id 编号， 传 入 的 是 int 类 型 
get_plugins info 获取 Master 节点 上 安装 的 所 有 插件 信息 ， 相 关 的 参数 包括 : 
9 depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 2 
get_all jobs 获取 所 有 的 Jenkins 任务 ， 结 果 以 Python List 形式 返回 ， 相 关 的 参数 包括 : 
© folder depth: 搜索 的 目录 层级 ， 传 入 的 是 int 类 型 ， 默 认 值 为 (None 代表 会 
在 所 有 的 目录 层级 中 进行 查找 ) 
create_job 创建 一 个 Jenkins 任务 ， 相 关 的 参数 包括 : 


€ name: 待 创建 的 Jenkins 任务 的 名 称 

@ config xml: 待 创建 的 Jenkins 任务 的 xml 配置 文件 

delete_job 删除 一 个 Jenkins 任务 ， 相 关 的 参数 包括 : 

@ name: 待 删除 的 Jenkins 任务 的 名 称 

disable job 关闭 一 个 Jenkins 任务 。 执 行 操作 后 ， 该 Jenkins 任务 将 不 会 再 被 执行 。 相 关 的 参 
数 包括 : 

@ name: 待 关闭 的 Jenkins 任务 的 名 称 

enable job 打开 一 个 被 关闭 的 Jenkins 任务 。 执 行 操作 后 ， 该 Jenkins 任务 将 会 再 次 被 执行 ， 
相关 的 参数 包括 : 

€ name: 待 打开 的 Jenkins 任务 的 名 称 
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(BER) 


名 称 


描述 


get_job_config 


获取 某 个 Jenkins 任务 的 配置 信息 ， 结 果 以 xml 的 形式 返回 ， 相 关 的 参数 包括 : 
@ name: Jenkins 任务 的 名 称 


get_nodes 获取 已 经 和 Master 节点 建立 连接 的 所 有 Jenkins 节点 结果 以 Python List 的 形式 进 
行 返回 ， 相 关 的 参数 包括 : 
9 depth: JSON 的 深度 ， 传 入 的 是 nt 类 型 ， 默 认为 0 

get_node info 获取 某 个 Jenkins 节点 的 相关 信息 ， 结 果 以 Python 字典 的 格式 进行 返回 ， 相 关 的 


参数 包括 : 
© name: 节点 的 名 称 
9 depth: JSON 的 深度 ， 传 入 的 是 int 类 型 ， 默 认为 0 


create node 


disable node 


enable_node 


delete_node 


创建 一 个 Jenkins 节点 ， 相 关 的 参数 包括 : 

name: 待 创建 的 Jenkins 节点 的 名 称 ， 传 入 的 参数 为 String 类 型 值 
numExecutors: 该 节点 分 配 的 执行 器 的 数量 ， 传 入 的 参数 为 int 类 型 值 
nodeDescription: 待 创建 的 节点 的 描述 信息 ， 传 入 的 参数 为 String 类 型 值 
remoteFS: 远程 文件 系统 的 路 径 ， 传 入 的 参数 为 String 类 型 值 

labels: 给 待 创建 节点 打 的 标签 ， 传 入 的 参数 为 String 类 型 值 
exclusive: 是 否 使 用 该 节点 仅仅 执行 国定 的 任务 ， 传 入 的 参数 为 布尔 类 型 值 
launcher: slave 节点 的 运行 方式 。Jenkins 提供 了 4 种 运行 方式 : 

> jenkins LAUNCHER COMMAND. 

> jenkins LAUNCHER SSH. 

> jenkins LAUNCHER JNLP. 

> jenkins LAUNCHER WINDOWS SERVICE. 


9 launcher params: 附加 的 执行 参数 ， 传 入 的 参数 为 Python 字典 类 型 


关闭 一 个 Jenkins 节点 ， 相 关 的 参数 包括 : 
€ name: 待 关闭 的 Jenkins 节点 的 名 称 


€ msg: 关闭 节点 时 的 通知 信息 


打开 一 个 Jenkins 节点 ， 相 关 的 参数 包括 : 
© name: 待 打开 的 Jenkins 节点 的 名 称 
删除 一 个 Jenkins 节点 ， 相 关 的 参数 包括 : 
© name: 待 删除 的 Jenkins 节点 的 名 称 


Jenkins 的 Python API 中 还 提供 了 很 多 和 Jenkins 操作 相关 的 接口 方法 ， 更 多 的 内 容 可 以 
参考 https://python-jenkins.readthedocs.io/en/latest/api.html#jenkins.Jenkins。 

我 们 来 看 一 个 Python API 的 运行 示例 。 下 面 这 段 Python 脚本 代码 首先 引入 Jenkins 这 个 
package, 然后 连接 到 本 地 已 经 启动 的 Jenkins 服务 器 上 , 并 且 打 印 出 该 Jenkins 服务 器 上 的 job 
总 数 以 及 获取 的 所 有 Jenkins job 任务 。 
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import jenkins 


server = jenkins.Jenkins('http://localhost:8080/jenkins/', username='admin', 
password-'admin') 

print server.jobs count () 

print server.get all jobs (0) 


运行 结果 如 图 8-1-5 所 示 。 


“Ci Pregon Files W83) rien python exe” 了 /reject/rsbet-framess]/con/rebet/renste/ oemglayJrakiasgewmgle py 
1 
a i w wear Wettaile w fulin’ wrobetframeverk’, w elass > nen mode) Treestyltrraeet nme w rebatfrwesery H| 


Process Ginished with exit code 9 


8-1-5 


一 般 我 们 在 配置 一 个 Jenkins 任务 时 会 包含 图 8-1-6 的 常见 步骤 。Jenkins 任务 的 执行 需要 
依赖 很 多 不 同 的 插件 ，Jenkins 的 一 大 特性 就 是 提供 了 非常 丰富 的 插件 。 


任务 创建 


配置 任务 名 称 


任务 运行 环境 配 
a 


+ 


任务 执行 前 置 工 
作 


* 


"t subversiondili 编译 插件 执行 Report 生 || | s 
任务 执行 插件 — | SUM | Ansmaver.| [t| 执行 插件 | 上 一 对 | awas |P" 


¥ 


任务 执行 后 置 工 
作 


任务 执行 结果 通 


x 
接收 任务 执行 结 
果 


任务 结束 


8-1-6 
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8.1.2 在 Jenkins 上 运行 Robot Framework 自动 化 测试 用 例 


我 们 首先 需要 建立 一 个 Robot Framework 的 构建 任务 ， 并 在 任务 中 配置 重 试 次 数 、 构 建 的 
依赖 日 志 等 ， 如 图 8-1-7 所 示 。 


Gener! DES 2s 6 ECE 


mè RobctFramework ers CIS BbR E 


eA BE 
= aman 
STETE 
xe 
USt eI 
a eem 
2 mere 


e0 090o 


SOM THREES |2 
2 TERM LRA ETRE HEBER 
* WURESIFEOUBIGHBEfSFHATER 
使 用 所 定义 的 工作 三 同 
[d 


e° eee 


9 erac 


~ IE 


图 8-1-7 


然后 配置 自己 的 源码 管理 。 我 们 可 以 在 这 个 步骤 中 配置 测试 用 例 的 路 径 等 ， 如 图 8-1-8 所 示 。 


mx 


构建 触发 器 
HTEO (pisc 使用 加 | 
本 他 工作 对 后 相交 
| anme 


eee. 


sc sc 


E - 


8-1-8 


接着 配置 构建 触发 器 。 顾 名 思 义 ， 触 发 器 就 是 配置 任务 触发 的 方式 、 触 发 时 间 。Jenkins 
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支持 触发 远程 构建 、 其 他 工程 构建 后 触发 、 定 时 构建 、 轮 询 SCM 这 几 种 构建 触发 方式 ， 如 图 


8-1-9 所 示 。 
e 
e 
Dene TIS Geh 
Beats ns eee 
menm LJ 
Hex e 
AoE 
# sei soM ° 
Lj ° 
无 计划 , krimi post-commit TES 
pem ° 
= 


8-1-9 
构建 触发 器 步骤 中 相关 输入 参数 的 描述 如 表 8-1-2 所 示 。 
表 8-1-2 构建 触发 器 步骤 中 相关 输入 参数 


选项 说 明 
触发 远程 构建 通过 远程 调用 的 方式 3cHRIENKINS URL/job/robotframework/build?token-TOKEN _ 
NAME 或 者 /buildWithParameters?token-TOKEN NAME 两 种 方式 ， 在 调用 时 需要 
用 身份 验证 令 牌 token 来 进行 身份 验证 
其 他 工程 构建 后 触 | 其 他 的 任务 在 构建 完成 后 就 会 自动 触发 当前 的 任务 运行 ， 可 以 指定 只 有 其 他 任务 运 
发 行 成 功 后 才能 触发 当前 任务 ， 也 可 以 指定 其 他 任务 构建 失败 时 触发 当前 任务 
定时 构建 可 以 指定 通过 定时 任务 的 形式 来 触发 构建 。 触 发 的 形式 (和 我 们 见 过 的 很 多 定时 任 
务 触发 器 很 像 》 如 下 : 
MINUTE HOUR DOM MONTH DOW 
@ MINUTE: 表示 分 钟 ， 取 值 为 0~59。 若 其 他 值 不 做 设 定 ， 则 表示 每 个 设 定 的 
分 钟 都 会 构建 。 例 如 5**** ， 表 示 每 小 时 的 第 5 分 钟 都 会 构建 一 次 
@ HOUR: 表示 小 时 ， 取 值 为 0-23。 若 其 他 值 不 做 设 定 ， 则 表示 每 个 设 定 小 时 的 
每 分 钟 都 会 构建 。 例 如 *5*** ， 表 示 在 每 天 5 点 的 时 候 ， 在 一 小 时 内 每 一 
分 钟 构建 一 次 
© DOM: 表示 一 个 月 的 第 几 天 ， 取 值 为 1~31。 若 其 他 值 不 做 设 定 ， 则 表示 每 个 
月 的 那 一 天 每 分 钟 都 会 构建 一 次 。 例 如 ** 5*#*+， 表 示 在 每 个 月 5 号 的 时 候 ， 
从 0 点 开始 每 分 钟 构建 一 次 
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© MONTH: 表示 第 几 月 ， 取 值 为 1~12。 若 其 他 值 不 做 设 定 ， 则 表示 每 年 的 那个 
月 每 分 钟 都 会 构建 一 次 , 例如 ***5*, 表示 在 每 年 的 5 月 份 , 从 1 号 0 点 开 
始 每 分 钟 构建 一 次 

€ DOW: 表示 一 周 中 的 第 几 天 ， 取 值 为 0-7， 其 中 0 和 7 代表 的 都 是 周 日 。 若 
其 他 值 不 做 设 定 ， 则 表示 每 周 的 那 一 天 每 分 钟 构建 一 次 。 例如 ****5, 表示 
每 周 五 从 0 点 开始 每 分 钟 构建 一 次 

轮 询 SCM 表示 配置 任务 轮 询 来 执行 ， 配 置 的 方式 和 定时 构建 非常 相似 


在 配置 完 构建 触发 器 后 ,接着 可 以 配置 构建 步 又， 也 就 是 自动 化 测试 用 例 的 执行 步 又， 如 
图 8-1-10 所 示 ， 构 建 步骤 可 以 配置 多 个 ， 每 一 个 构建 步骤 都 可 以 通过 拖 动 的 方式 来 调整 其 执 
行 的 先后 顺序 。 


eral m 
构建 


执行 Windows 批 处 理 命令 加 e 
$e 


SA Daas 
ER.. 


woh a, 


fç 


= DRE 
Sn. 


[rs ~ 


执行 Windows IRURE C 
执行 shel 
调用 顶层 Maven 目标 


图 8-1-10 
表 8-1-3 中 描述 了 两 种 不 同 构建 方式 的 区 别 。 
表 8-1-3 不 同 构建 方式 的 区 别 


i 说 明 
一 般 用 于 Windows 环境 上 执行, 可 以 是 一 个 Windows 的 批 处 理 命令 或 者 是 调 
用 一 个 Windows 的 批 处 理 脚 本 
执行 shell 一 般 用 于 Linux 环境 上 执行 ， 可 以 是 一 条 Linux 的 操作 命令 或 者 是 调用 一 个 
Linux 上 的 shell 脚本 


在 这 里 配置 一 个 Windows 的 批 处 理 命令 来 执行 我 们 从 RIDE 中 已 经 编写 好 的 Robot 
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Framework 的 自动 化 测试 用 例 : pybot.bat --argumentfile c:\users\yongqing\appdata\local\temp\ 
RIDEbbpu6m.dvargfile txt --listener "C:\Program Files (x86)\python\lib\site-packages\robotide\contrib\ 
testrunner\TestRunnerAgent.py:32451:False" F:\project\RobotFrameworkTest]\RobotFrameworkTest1 , 


如 图 8-1-11 fim. 


Genera SPER 构建 
构建 
Pus Windows MEES S 
TA yyhot.bat —Aarcunentfils 0: \usere\yoneaane appéara local temp RIDESEpuGn, d\areiile, ts: listener "C:lProgran 
Files (386) \python\Lib\site-packages\xobotide\contrib \testrumex VTes tLunnezázent, ny:32d51; False" 
F: \project\RobotFxancxoxkToxth \RobatExancrarkTeath 
SA 可 用 环境 变量 列表 
Sa. 
a 
图 8-1-11 


最 后 构建 任务 结束 后 的 操作 ,包括 归档 、 继 续 构建 其 他 的 工程 任务 、 


图 8-1-12 所 示 。 


用 于 存档 的 文件 


RETE 
要 构建 的 项 
目 没有 指定 工程 
a 只 有 构建 稳定 时 钥 发 
在 构建 不 稳定 时 依然 触发 
即使 构建 失败 时 也 会 触发 


记录 文件 的 指纹 用 于 追 际 
需要 记录 指纹 的 文件 


增加 构建 后 操作 步 可 v 


ENB- 


记录 指纹 跟踪 等 ， 如 


8-1-12 


在 任务 创建 完成 后 ， 我 们 就 可 以 构建 已 经 配置 好 的 自动 化 测试 用 例 任务 了 ， 如 图 8-1-13 


第 8 章 自动 化 测试 框架 的 设计 


Jenkins robotframework 


$ 运 回 面板 


Q, 状态 


工程 robotframework 


RobotFramework 自 动 化 测试 案例 执行 


= wis 


@ 工作 空间 


^ Build History 构建 历史 = 


RSS 全 部 EJ RSS 失败 


图 8-1-13 
在 任务 执行 完成 后 ， 我 们 可 以 查看 自动 化 测试 用 例 任务 的 构建 执行 日 志 ， 如 图 8-1-14 所 


ES 


Q 控制 台 输 出 


图 8-1-14 


自动 化 测试 用 例 执行 完成 后 ， 我 们 也 可 以 查看 到 测试 用 例 RobotFramework 为 我 们 自动 生 


" 


成 的 自动 化 测试 用 例 执行 报告 ， 如 图 8-1-15 和 图 8-1-16 所 示 。 
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All tests passed 
20180923 11:36:12 638 
20180923 11:36:12 673 
00:00:00.035 

log html 


+ Tota: Pass Fail + Elapsed+ 
Critical Tests 1 1 0 00:00:00 mm—nÓ— 
All Tests 1 1 0 00:00:00 es | 


Statistics by Tag + Tota: Pass Fail + Elapsed Pass/Fail 
No Tag 


Statistics by Suite. * Totals Pass > 
RobotFrameworkTestt 1 1 
RobotFrameverkTestt . TestSuitet 1 1 


Tags — Suites 
Type: © Critical Tests. 
© All Tests 
图 8-1-15 
Total Stites = Teac Passe Fall = Elpseds Pass /Foll 
Critical Tosts 1 1 . 0000 w— 
All Tests 1 1 O 000000 mo 
Statistics by Tag * Totale Passe Fal Elapseds Pass/Fail 
No Tags 
Statistics by Suita = Tomi Pase Fole Elapeeds Pass/Fail 
Robot rameworklestt 1 O 1 wa 
RebotomvwrkTest TestSuito1 1 O 00000 w— 
st Execution Log 
- ETID Robo iameworkTestt 10 00 0003 
Full Name: RobotFramework Test 
Source: F orosectiRobotF rameworkTest! Robotf rameworkTest t 
Start! End / Elapsed: — 20100225 14 36 12 636 / 20180823 11 36:12 673/00 00 00 035 
Status: + critical test, ! passed C faledi 
4 teat total, 1 passed. 0 falsa 
= EUIS resww 000200 0% 
Full Namo: RobctFramewod Test! TestSuite1 
Source: F \erjectRobeaFrameyerkTest Rebel ramewert Tent Tete t 
Start! End! Elapsed: — 20180623 11:36:12 8664 / 20180923 11:36:12 672 / 00.00.00 008. 
Status: 3 ertcal tet, 1 passed 0 talo 
‘est tla. 1 passed 0 failed 
- EIER estCaseno2 00.00.00 005 
Full Name: RobotF rameworkTest | TestSuitet TestCase002 
Start / End / Elapsed: — 20150923 11:36:12 666 / 20160923 11:36:12 671 / 00:00:00.005 
Status: [ws 
+ CELI Gis - eam. Create List helo. robot ramencrk 0.00 0000 
+ CELE sam Log $t) 00.00.00 t 
+ Du Log Many Qt! 0000000 
图 8-1-16 


8.2 如 何 做 好 自动 化 测试 平台 框架 的 设计 


自动 化 测试 如 果 需 要 能 高 效 快 速 地 支撑 软件 项 目的 测试 、 项 目的 快速 欠 代 以 及 上 线 , 除了 
以 上 我 们 介绍 的 需要 许多 的 Lib 来 支持 以 及 需要 高 效 地 去 编写 自动 化 测试 用 例外 , 还 需要 一 个 
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好 的 自动 化 测试 框架 平台 来 支撑 我 们 的 自动 化 测试 用 例 的 执行 以 及 分 析 。 自 动 化 测试 平台 一 般 
需要 解决 测试 用 例 执行 任务 的 创建 、 任 务 的 管理 、 任 务 的 调度 、 测 试用 例 的 解析 ， 测 试用 例 分 
别 根据 不 同 的 测试 类 型 分 发 给 不 同 的 测试 工具 或 者 测试 Lib 库 进 行 执行 , 并 且 需 要 对 执行 的 数 
据 进 行 分 析 ， 得 出 质量 数据 ， 然 后 才 好 给 出 对 应 的 测试 报告 分 析 数 据 给 测试 经 理 ， 由 项 目 经 理 
来 辅助 持续 地 改善 项 目 版 本 的 质量 。 图 8-2-1 是 一 个 自动 化 测试 平台 框架 的 架构 设计 图 。 


— 一 | 
2 [sein ee | 
xn | le 任务 调度 器 cha! 
mm] E5372 LT NY | la | 
据 (svn) 案例 解 d 
析 器 |I 4 ae — 短信 平台 自动 
“| SS Boe 
i | | | 测试 报告 ”一 | 邮件 服务 器 
执行 日 志 数 据 台 
ken w | 
数据 明细 | ed 
kasa) EK m H e H 
Kibana Ed * 
图 8-2-1 


框架 图 中 的 自动 化 测试 平台 框架 主要 包含 4 部 分 : 自动 化 测试 用 例 编写 的 IDE TA, A 
动 化 测试 用 例 的 执行 ， 测 试 任务 的 管理 和 监控 ， 测 试用 例 执行 后 的 数据 分 析 。 
一 个 通用 的 自动 化 测试 用 例 编写 的 IDE 工具 一 般 需要 包含 的 功能 如 图 8-2-2 所 示 。 


通用 友好 的 用 户 案例 编写 界面 ， 通 
A 常 可 以 是 表格 表单 的 形式 
/ 
/ | 友好 的 关键 字 或 者 API 使 用 界面 ， 比 
/ P nt M pF TAB ALB iH EK, 


40b 库 的 管理 , 包括 Lib 库 的 导入 加 载 等 
L 


IDE \ NN YS FUERAT. PLE NAPIER 


\ | 关键 字 的 编写 
NON Itf ORT, EA 
NN a 点 、debug 模 式 等 
| 日 志 豚 别 以 及 日 志 答 出 的 维护 和 友 
\ | 好 展示 


\ | 
| 用户 变 量 数据 和 测试 案例 输入 数据 
的 管理 和 维护 


8-2-2 
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友好 的 用 户 案例 编写 界面 一 般 可 以 用 表格 或 者 表单 的 形式 来 完成 ， 比 如 Robot Framework 
就 是 典型 的 表格 界面 ， 也 可 以 用 Eclipse 的 插件 式 开发 实现 这 一 需求 。 

在 平台 中 ， 一 个 自动 化 测试 用 例 的 执行 一 般 包 括 如 图 8-2-3 所 示 的 基本 步骤 ， 最 核心 的 就 
是 将 解析 的 案例 数据 分 发 给 不 同 的 Lib 库 去 执行 。 


测试 案例 数据 的 拉 取 〈 比 如 


svn. git) 


| 


测试 案例 数据 的 解析 


| 


解析 好 的 数据 发 往 各 个 不 同 的 
执行 服务 


| 


底层 Lib 库 执行 或 者 远程 Lib 库 运行 


| 


生成 测试 结果 


图 8-2-3 
在 做 数据 分 析 时 ， 可 以 借用 很 多 现在 主流 的 大 数据 组 件 ， 如 图 8-2-4 所 示 。 数 据 分 析 通常 
包括 实时 数据 分 析 和 离线 数据 分 析 , 在 分 析 中 我 们 还 会 用 到 很 多 消息 队列 中 间 件 , 比如 Kafka。 
数据 明细 可 以 采用 Elasticsearch 来 进行 存储 ， 这 和 Elasticsearch 本 身 的 特点 有 关系 ， 可 以 支持 
大 数据 的 存储 ， 方 便 以 后 我 们 来 做 全 文 检索 。 


Spark, Storm, Flink | 


A 实时 数据 分 析 | = 
数据 分 析 <L 
= — NY 离线 数据 分 析 | Hive, Hadoop“ 
8-2-4 
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平台 框架 图 中 包含 的 组 件 如 表 8-2-1 所 示 。 
表 8-2-1 平台 框架 图 中 包含 的 组 件 


组 件 说 明 
IDE RIDE、Eclipse 插件 、IDEA 插件 
自动 化 测试 用 例 数据 | 自动 化 测试 用 例文 件 


案例 解析 器 负责 自动 化 测试 用 例文 件数 据 的 读 取 和 解析 ， 翻译 成 自动 化 测试 工具 或 者 自动 化 测 
3& Lib 库 可 以 执行 的 命令 
资源 监控 和 


负责 各 个 执行 器 、 案 例 解析 器 以 及 自动 化 工具 服务 器 的 资源 监控 和 资源 管理 
调度 自动 化 测试 执行 任务 在 多 个 节点 上 的 执行 


任务 调度 器 
自动 化 任务 管理 器 aoe 自动 化 任务 的 管理 〈 任 务 启 用 、 任 务 停 用 、 任 务 新 增 、 修 


资源 管理 


任务 执行 异常 、 超 时 等 ， 自 动产 生 告警 
负责 告警 短信 的 发 送 以 及 短信 发 送 规则 的 配置 
接收 生成 的 测试 报告 或 者 告警 信息 ， 然 后 以 邮件 形式 发 送 给 对 应 的 相关 人 员 
执行 日 志 数据 的 缓存 队列 存储 
测试 用 例 执行 的 日 志明 细 数 据 存储 ， 支 持 全 文 搜索 
一 个 开源 的 分 析 和 可 视 化 平台 ， 引 在 与 Elasticsearch 进行 结合 。Kibana 提供 了 搜 
Kibana 索 、 查 看 和 与 存储 在 Elasticsearch 索引 中 的 数据 进行 交互 的 功能 。 开 发 者 或 运 维 人 
员 可 以 轻松 地 执行 高 级 数据 分 析 ， 并 在 各 种 图 表 、 表 格 和 地 图 中 可 视 化 数据 
负责 对 日 志 定时 做 离线 分 析 处 理 ， 比 如 通过 Hive 等 大 数据 方式 进行 数据 归 类 分 析 
将 日 志 数据 ， 通 过 大 数据 实时 数据 流 的 分 析 ， 提 取 案例 执行 过 程 的 相关 日 志 数 据 做 
实时 的 分 析 和 统计 ， 常 用 的 实时 流 分 析 工具 有 Spark, Storm, Flink 等 


图 8-2-5 是 自动 化 平台 框架 设计 的 一 个 分 层 结构 图 。 


no B/APHE A 案例 执行 结果 | 。 执行 结果 分 析 "— 

rm 框架 /API 介 绍 IDE 下 载 HE 展示 测试 报告 

M 任务 调度 服务 | 任务 管理 服务 告警 服务 监控 服务 MRO š eee 

jd 系统 管理 解析 器 管理 MM 操作 日 志 管 理 权限 管理 | aaa 
NR Selenium Appium Monkey Uib 库 Remote Lib 库 

数据 

处 理 Storm Spark Flink Hadoop steve 

数据 

fet Mysql Hive Elasticsearch Kafka | o see 


图 8-2-5 
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我 们 对 常见 的 自动 化 测试 架构 思想 做 一 个 对 比 ， 如 表 8-2-2 所 示 。 


名 称 


表 8-2-2 常见 的 自动 化 测试 架构 思想 的 对 比 
说 明 


数据 驱动 测试 


数据 驱动 测试 的 思想 是 将 我 们 的 自动 化 测试 脚本 和 测试 数据 放 在 共同 的 测试 架构 中 ， 提 
供 可 重用 的 测试 逻辑 。 这 样 做 的 目的 是 减少 测试 维护 的 工作 量 以 及 便于 改善 测试 用 例 的 
覆盖 率 。 测 试用 例 需 要 输入 的 测试 数据 和 测试 完成 后 的 测试 结果 数据 都 会 被 存储 在 同一 
个 数据 库 或 者 数据 源 中 ， 并 且 将 测试 的 数据 和 测试 逻辑 分 开 。 这 样 测试 数据 发 生 了 变化 
时 不 会 影响 到 我 们 的 测试 逻辑 ， 并 且 同 一 套 测 试 逻辑 可 以 针对 多 种 数据 来 进行 测试 ， 尽 
量 提高 测试 逻辑 的 使 用 效率 和 复 用 效率 


模块 驱动 测试 


关键 字 驱 动 测 试 


混合 自动 化 测试 


基于 模型 测试 


行为 驱动 开发 


模块 驱动 测试 的 思想 是 使 用 独立 的 脚本 或 者 代码 来 对 应 每 一 个 待 测试 的 模块 单元 和 功 
能 。 模 块 驱动 测试 引入 的 是 编程 语言 中 的 面向 对 象 编程 中 的 抽象 和 模块 独立 封装 的 思 
想 ， 即 将 测试 代码 和 每 一 个 测试 模块 进行 解 厢 ， 减 低 自 动 化 测试 脚本 或 者 自动 化 测试 代 
码 的 维护 成 本 ， 同 时 增强 可 扩展 性 。 测 试 的 执行 者 不 需要 知道 单元 模块 的 内 部 实现 ， 只 
需要 调用 单元 模块 对 外 提供 的 抽象 接口 方法 即 可 ， 单 元 模块 的 功能 需求 发 生变 化 时 ， 只 
需要 修改 该 单元 模块 的 内 部 实现 ， 对 外 提供 的 抽象 接口 方法 依然 可 以 做 到 不 发 生变 化 
Robot Framework 就 是 一 种 典型 的 关键 字 驱 动 测试 的 框架 模式 。 关 键 字 驱动 测试 通常 也 
被 认为 是 表格 驱动 测试 ， 通 过 在 表格 中 调用 关键 字 来 实现 自动 化 测试 。 这 种 设计 思想 一 
般 会 将 自动 化 测试 拆 分 为 设计 和 实现 两 个 不 同 的 阶段 。RedwoodHQ 自动 化 测试 工具 框 
架 也 是 靠 这 种 思想 来 实现 的 ， 设 计时 需要 尽量 考虑 关键 字 的 通俗 易 懂 以 及 通用 性 ， 也 就 
是 可 以 在 不 同 的 测试 用 例 或 者 场景 中 高 效 地 复 用 。 关 键 字 驱 动 测试 的 优点 在 于 自动 化 测 
试用 例 的 编写 者 不 需要 对 脚本 语言 有 非常 深入 的 了 解 就 可 以 完成 自动 化 测试 用 例 的 编 
写 

混合 自动 化 测试 是 上 面 几 种 自动 化 测试 思想 的 综合 使 用 。 关 键 字 驱动 测试 和 模块 驱动 测 
试 在 很 多 情况 下 就 可 以 完美 地 结合 起 来 使 用 ， 比 如 我 们 可 以 使 用 Robot Framework 提供 
的 自 定义 用 户 关键 字 来 对 单元 模块 业务 进行 封装 ， 封 装 完成 后 再 提供 一 个 新 的 用 户 自 定 
义 关键 字 。 新 的 用 户 自 定义 关键 字 就 可 以 认为 是 一 个 抽象 的 接口 

一 般 基 于 模型 测试 的 思想 用 得 较 少 ， 只 能 适合 于 特定 的 也 是 基于 这 种 模型 设计 思想 的 系 
统 。 通 常情 况 下 ， 这 一 测试 模型 是 全 部 或 者 部 分 从 待 测试 的 软件 系统 的 功能 模型 中 提取 
出 来 的 。 在 测试 模型 中 描述 了 待 测试 系统 的 抽象 行为 ， 因 此 从 测试 模型 中 也 可 以 派生 出 
功能 测试 用 例 

行为 驱动 开发 是 一 种 敏捷 开发 的 思想 ， 使 用 简单 的 、 特 定 于 领域 的 脚本 语言 (DSL) 将 
结构 化 自然 语言 语句 转换 为 通俗 易 懂 的 可 执行 测试 。 行 为 驱动 开发 的 根基 是 一 种 “通用 
语言 ”， 通 俗 易 懂 ， 同 时 被 客户 和 开发 者 用 来 定义 系统 的 行为 。Cucumber 就 是 一 种 行为 
驱动 开发 的 自动 化 测试 工具 
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号 .了 ”其 他 常用 的 自动 化 测试 框架 介绍 


8.3.1 RedwoodHQ 介绍 


RedwoodHQ 与 Robot Framework 有 所 不 同 ， 它 可 以 提供 一 个 网 站 界面 ， 允 许多 个 测试 团 
队 中 的 多 个 人 员 一 起 协作 ， 支 持 用 Java, Groovy. Python 和 C# 等 热门 的 编程 语言 来 实现 自动 
化 测试 脚本 。RedwoodHQ 提供 的 IDE 是 Web 的 形式 ， 但 是 也 是 基于 关键 字 的 方式 来 进行 操 
作 。 要 创建 一 个 测试 脚本 ， 只 需要 找到 要 执行 的 操作 ， 将 其 拖 动 到 测试 用 例 中 ， 然 后 输入 其 期 
望 的 参数 值 。RedwoodHQ 在 GitHub 上 的 开源 代码 地 址 是 https://github.com/ 
dmolchanenko/RedwoodHQ， 如 图 8-3-1 所 示 。 


C [e ££ | hüps//github.com/dr OARedwcodHO 
E dmoichanenko / RedwoodHQ Qa 37 Ws | 06 | Yro | 20 
© Code Issues I [Pul requests 3 — [F Projects 0 Insights 
Join GitHub today 
GitHub is home to over 28 million developers working together to host 回 


and review code, manage projects, and build software together 


No description, website, or topics provided. 


1D 932 commit: P1 branch © Oreleases 414 contributors MDGPL-30 


Branch: master > 


[ peace 


lig agent 
in ci 


is doscnpts 


li project templates. 


is pubiic 


i routes 


图 8-3-1 


通过 访问 官方 的 网 址 http://redwoodhq.com/ 可 以 下 载 RedwoodHQ 进行 安装 和 使 用 ,如 图 
8-3-2 所 示 。 
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C [O redwoodhqcom arl 
dx Primalest 


hh RedwoodHQ 


Automate, Execute, Analyze, Collaborate 


Overview Download Automation Services Docs Form Looking Glass 


we 
It is a free Open Source test automation framework that works with any ji 


tool (Selenium, Appium, Silk, etc.) and is VERY easy to install! RedwoodHQ 

allows multiple users to develop automation code, create readable | See ItIn Action | 
action/keyword driven test cases and execute them all using a friendly Web — * 

Interface. 


Redwood: supports any Java/Groovy, Python and C# code or test tools like Selenium, 
Appium, etc., can be used for back-end as well as front-end automation and has already proven 
itself in companies like ‘Hitachi Data Systems’ and many others 


Any Java, Python, C# Tool and Action/Keyword Driven Framework Integrated IDE 
Code Powerful and easy to use framework allows Analyze, modify, create, and bulld automation 
RedwoodHQ works with anything for automation engineers to enable the rest of scripts using embedded IDE (or plug in your 
JavalGroowy, Python and C# to test things ike — the team to participate in creating readable own) 
API SOAPIREST, Database, CLI, etc. Or automated test cases. Optionally, the user = --—- 
connect your favorite Automation Tool like: n Ae ee SS POG OE ME opt ‘package actions selenium 
and bypass the framework layer. pou 
Selenium, Appium, Silk4J, etc. to do any UI byp: lay Cert xime th ient 


图 8-3-2 
RedwoodHQ 可 以 支持 SOAP, REST 等 服务 ， 也 支持 对 常见 数据 库 的 操作 ， 还 支持 连接 
到 常用 的 自动 化 测试 工具 ， 比 如 Selenium. Appium. Silk4J 等 。 
TE RedwoodHQ 的 Web IDE 提供 了 Execution (案例 执行 )、Test Cases (案例 编写 )、Actions 
(关键 字 ) Scripts (测试 脚本 ) ~ Settings (IDE 设置 ) 5 个 功能 菜单 ， 如 图 8-3-3 所 示 。 


© [O 12700.1:3000/index html 


E Variables 
i Machines 


Amana Shopping Ready To ur 000 


图 8-3-3 
Test Case 菜单 下 提供 了 测试 用 例 的 编写 功能 ， 如 图 8-3-4 所 示 。 
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7 Test Case Details 


| -~ History 
7 After State 


+ Action Collection 


[BT Search tor Action using name or tags v DP He 
~ | Acton Neme Execution Flow Parameter Name | Parameter Valve | Ratun Value Machine Role 


8-3-4 


通过 单 击 轧 NewTescase 按钮 ， 可 以 新 建 一 个 自动 化 测试 用 例 ， 并 且 可 以 在 Action 中 选择 可 
用 的 关键 字 操 作 ， 如 图 8-3-5 所 示 。 


[B New Test Case ld QDelete (D D 

Test001 

* Test Case Details 3 
Name: [ 

Description: | “Segoe UI" 3 87 U Ke A-Z- EBB f iiio 


Status: To be Automate, V 

Tags: ga 
Test Case Junit C TestNG O Script O Pytest ® Action Collection 
Type: 

* History 

7 After State 

|^ Action Collection. 


[e um Fi gi s: z 


Add to Cart 二 | Parameter Name Parameter Value — Return Value | Machine Role - | 
et i | | 
Click on Element 

| selenium 

| Close All Browsers 
selenium 


| Close Current Window. 
selenium. 


| Delete Cookie 
| selenium. 


Double Click on Element 
selenium. 


图 8-3-5 


切换 到 Actions 菜单 下 ， 可 以 看 到 RedwoodHQ 已 经 自 带 支持 的 关键 字 动 作 ， 默 认 已 经 支 
持 了 Selenium 工具 ， 如 图 8-3-6 所 示 。 
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Redwood i — Download Agent @ choose Project sample v admine 


Test Cases Scripts — Setüngs 


m * 
pasto cat = 
di Cik on Element 

Q Close All Browsers 

Q Close Curent Window 

Q Deete Cookie 

di Daudie ict on Element 

Q Drag And Drop to Element 

@ Execute Javascript 

Q Ges Cookie Value 

d Cet Element Text | 
[II 

d Co Forward 

Q Meuse Over Element 
d Navigate to URL 

d Open Browser 

d Ree 

d) Right Ci on Element 
Q Search Arazon 

d Salet ttem 

Q Select kem In Element 
d Send Keye to Element 
Q Se" Chectbow 


d Set fecus on Element * 


图 8-3-6 
通过 单 击 加 NewAsen 按钮 ， 可 以 新 建 一 个 自 定 义 的 Action， 如 图 8-3-7 所 示 。 在 此 可 以 选择 
Action 的 类 型 以 及 可 以 对 自 定义 编写 的 Action 指定 标签 和 对 应 的 实现 语言 。 
Là New Acton fe] @ osa 回转 


^ Action Details 


Description: 


Action Type: * Script Action Collection 

Status: Tobe Automated ~ 

Tags: ` 
> History 
Used In Test Cases/Actions 


Q Add Parameter 
Name Parameter Type | Possible Values 


Select Script: 


8-3-7 


表 8-3-1 中 列 出 了 两 种 Action 类 型 的 详细 说 明 。 
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表 8-3-1 两 种 Action 类 型 的 详细 说 明 


| Action 类 型 说 明 | 
Script 通过 测试 脚本 的 方式 来 实现 自 定义 的 Action， 脚 本 编写 支持 Java. Groovy. Python. 
C#， 并 且 可 以 指定 Action 执行 时 需要 的 参数 


Action Collection 选择 已 有 的 Action， 与 Robot Framework 中 的 用 户 自 定义 关键 字 类 似 ， 即 通过 对 已 有 
关键 字 的 二 次 封装 构建 出 一 个 新 的 用 户 关键 字 


切换 到 Scripts 菜单 后 ， 可 以 看 到 RedwoodHQ 下 的 所 有 脚本 ，RedwoodHQ 安装 好 后 ， 已 
经 默认 集成 了 Selenium 了 , 并且 提供 了 已 经 用 Groovy 实现 的 一 部 分 脚本 ,如 图 8-3-8 和 图 8-3-9 
所 示 。 


@ choose Project: sample 


amazon 

Fi general 

E selenium. 

B ik External Libraries 
El sitignore 


[EI wseringsxml 
IE PpReurements 


8-3-8 


Scripts. « 
E B utils E 
@ Browser.groovy 
@ Click groovy 
@ CloseBrowser.groovy 
@ CloseWindow.groovy 
(9) DeleteCookie. groovy 
@ DoubleClick groovy 
@ DragAndDrop.groovy 
@ Executelavascriptgroovy 
@ Exists. groovy 
@ GetCockieValue.groovy 
@ GetTextgroovy 
@ GoBackgroovy 
9 GoForward groovy 
@ MouseOver.groovy 
@ NavigateToURL groovy 
@ Refresh groovy 
@ RightClick groovy 
@ Selectitem.groovy 
@ SendKeys.groovy 
@ SetCheckBox.groovy 
@ SetFocus. groovy 
@ SetText.groovy 
@ SetTimeout groovy 
@ Submit groovy 
@ SwitchToDefaultContent groovy 
@ SwitchToFrame groovy 
(9) SwitchWindow.groovy 
@ VerifyAttribute groovy 
@ VerityCheckBox.groovy 
@ VerifyElementState groovy 
@ VerifyPageTitlegroovy * 


8-3-9 
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选择 其 中 一 个 脚本 文件 后 ， 可 以 查看 脚本 里 面 对 应 的 代码 实现 ， 如 图 8-3-10 所 示 。 可 以 
对 已 有 的 脚本 进行 修改 ， 也 可 以 新 建 一 个 自 定义 的 脚本 。 


Execution Test Cases Actions 


Onw- FO De BS © P I inpontercass - 


package actions, selenium; 


| 3 import org openga selenium YebDriver 
| $ import org openqs selenium ie InternetExplorerlriver 

© inport org openga selenium firefox Firefadriver 

© import org openqe selenium ie InternetExplor erBr iver 

7 import org openga selenium chr one, Chronelriver 
prm | 5 inport org openga seleniua de one ChroneDriverService 

| impart org openqa selenium ie InternetEcplor erDr iverServi ce 
` @ Browser-groowy | import org openga seleniun remote. Renote¥ebDriver 
@ Click. groovy | 1i import org epenqa selenium renote Desiredapabilities 


@ CloseBrowser groovy 13 diens Browser [ 

@ CloseWindow groovy n 

epoca coeguoy publie statie Yebriver Driver = mill 
@ DoubleClick.groovy public static Mainfinfandle = null 


@ DragAndDrop.groovy | . 
@ Executelavascript groovy 4 run (def parens) [ 
@ Exists.groovy i def os = Systen, getProperty(“ox mane”), teLoverCase(); 
@ GetCookieValuegroovy | println parans 
@ GetTestgroovy + sleep (1000) 
z if (pareas. "Browser Type" == *Firefez")[ 
@ Gobackgrooy 证 (or contains (nix) || os. contains Cmm) | los. contains ("aix")) { 
图 GoForward.groovy z Systen. setProperty (“web driver. gecko. driver”, "geckodriver^) 
@ MouseOver groovy new File Ceuckodriver ^), setExecutabl e (true) 
E 1 
@ NovigateTOURL groovy ‘se if (os, contains ("mae")) [ 
@ Refresh groovy Systen. setProperty ("webdriver. gecko. driver”, "geckodrivernac") 
mew File (geckedrivernac”), setExecut able (true) 
@ RightClick.groovy 1 
@ Selectitem groovy 1 sel 
@ sendieys groovy Eme s DOE i 
@ SetCheckBoxgroovy 
@ SetFocus groovy al 
@ SetTertgroowy U Ase if bores “Browser Type” == “Chrome”? [ 


@ SetTimeoutgroovy uo def service 
Submit groow i 


B 8-3-10 


新 建 自 定义 编写 脚本 时 ， 可 以 指定 脚本 编写 实现 的 语言 。 这 里 选择 用 Python 语言 来 实现 
脚本 ， 如 图 8-3-11 所 示 。 


Scripts 


om 1 elass PythonActi on: 
ay def run (self, parans) 
pass 


Bp actions 
il amazon 
ELE general 
Egi selenium 

ml utils 
Lë Pytho 


图 8-3-11 


8.3.2 Cucumber 介绍 


Cucumber 是 一 款 用 通俗 易 懂 的 普通 语言 来 描述 测试 用 例 并 且 支 持 行为 驱动 开发 (BDD) 
思想 的 开源 自动 化 测试 工具 。 它 是 一 套 通过 定义 DSL 来 验证 测试 结果 的 自动 化 测试 框架 ， 支 
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TF Ruby. Java. Net, JavaScript 等 多 种 常用 的 编程 语言 ， 由 于 是 基于 行为 驱动 开发 的 模式 ， 
此 这 款 自 动 化 测试 工具 很 适合 敏捷 开发 模式 的 团队 使 用 。 

通过 访问 Cucumber 的 官方 主页 https://docs.cucumber.io/ 可 以 看 到 其 相关 的 官方 文档 介 
绍 ， 如 图 8-3-12 所 示 。 


€ > Cac: | iii DEJ 


SH 


cucumber? 


Executable Specifications Eating tos moch of anything say not be good for you. 
Free, open source, any platform 


Eating tco mary cucumbers may rot be good far you 


Eating a few az no prcblen 
Alios ie mney 

Woon she ostz 3 cucumbore 

Then che vill bo full 


Get started Learn more Need More? 

Install Cucumber Cucumber Guides Tools that work with Cucumber 
Try the tutorial in Java, RB Gherkin reference Looking for the APT? 

or Ruby Cucumber reference 


Read about BDD 


you need 


图 8-3-12 


在 Cucumber 官方 网 站 上 给 了 一 个 DSL 的 示例 , 可 以 明显 看 出 Cucumber 行为 驱动 开发 的 
特点 ， 如 图 8-3-13 所 示 。 


# Comment 
Qtag 
Feature: Eating too many cucumbers nay not be good for you 


Eating too much of anything nay not be good for you. 


Scenario: Eating a few is no problem 
Given Alice is hungry 
When she eats 3 cucumbers 
Then she will be full 


图 8-3-13 
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